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Tired 


of low returns on shareware distribution? 

for an effective way to show off your products to more potential customers? 


Looking 


Thinking 


about using the Internet to distribute software? 


Show your stuff with 



The Demo Builder for Windows 
—the most useful demo tool around! 


Say hello to 

I Dan Bricklin's 


timeLOCK! 

The Ultimate Trialware Tool 
—Say goodbye to shareware! 



When You Can t 

BeThereYou&V- 


So many uses: 

• On-line demos 

• Electronic brochures 

• Sales presentations 

• Disk-based advertising 

• Tutorials 

• Interactive demos 

• Self-running demos 

..and more! 


■ 
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The Demo Builder for Win ows 


So popular: 

PC Magazine said, “When you can’t 
be there to demonstrate a program 
yourself, Dan Bricklin’s demo-it! 
makes an effective stand-in.” 
Windows Magazine said, “Windows 
evangelists who want to spread the word with a touch of flair can hardly go 
wrong with this powerful presentation tool.” And InfoWorld Magazine calls demo-it! “a 
first-rate tool with a variety of uses.” 



One by one, developers are making 
their applications ready for on-line 
distribution. Over 12 million potential 
customers are cruising the Internet 
looking for good software. They demand 
to “try before they buy." They don’t want 
crippled-ware, locked files or canned 
demos—and you don’t want to give away 
your software as shareware. So, how do 
you do it? Say hello to Dan Bricklin's 
timeLOCK!... 


The ultimate trialware tool! 

• Creates fully functional 
“timeLOCKed” versions of 
Windows® software. 


• Opens the door to new distribution channels. 


• Ideal for sales lead fulfillment, direct mail promotions and Internet distribution. 

• Converts to full-time operation (“untimeLOCKing”) only when user pays for license. 


So easy to use: 

Version 2.0 includes all of the easy-to-use demo-it! features introduced in the original 
version of this widely acclaimed demonstration tool, plus these enhancements: 

• Rich Text (RTF Format) • Variables 

• Heartbeat Clock • Simulated Typing 

• Filmstrip Animation • Object Sets 

• Scaling Bitmaps • Revised User Interface 

• Additional Transitions • Finer Timer Control 


Greater control—and easy to use! 

With one function call, Dan Bricklin's timeLOCK! allows potential customers to evaluate 
your fully functional program for a period of time. Set the trial period and timeLOCK! 
takes care of everything else. 


Product 


Product No. 


Price 


demo-it! V2.0.LIDSD31-FZ $399 

timeLOCK! Developer's Kit with first keycode module/16-bit.LIDBT31-FZ .$699 

timeLOCK! Developer's Kit with first keycode module/32-bit.LID3231-FZ .$699 

timeLOCK! Additional keycode module for telemarketers.LIDTK31-FZ $499 


Ask us about our “unlocking”service. 

CALL & ORDER TODAY! 

800 - 987-4929 

1163 SHREWSBURY AVE. • SHREWSBURY, NJ 07702 • VOICE: 908/389-0037 • FAX: 908/389-9227 • BBS: 908/389-9783 
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From the Editor 



Let's face it - when you need a disassem¬ 
bler you're looking for clear, reliable informa¬ 
tion. Those who have tried other products 
have been disappointed with the dismal re¬ 
sults. 

Clearly, a new standard of excellence! 

Sourcer solves these problems with ad¬ 
vanced analysis and simulation. The quality 
of output is so good that most DOS EXE & 
COM files and drivers reassemble perfectly, 
byte-for-byte identical to the original! 

To make the results easier to understand 
Sourcer provides detailed and descriptive 
comments for interrupt subfunctions, I/O 
ports and much more. Sourcer even lets you 
examine encrypted and packed programs. 


mov 

ax,2517h 


mov 

dx.offset int 17h entry 

int 

21 h 

: DOS Services ah=function 25h 


, set intrpt vector al to ds.dx 

mov 

dx,off set data 4 

('Halt when ? printed.') 




int 

21 h 

; DOS Services ah=function 09h 

; display char string at ds:dx 

mov 

dx,19h 



ah,31h 


int 

; DOS Services ah=function 31 h 


; terminate and stay resident 
; al=return code.dx=paragraphs 


virustst endp 




int_17h_entry proc 
pushf 

far 

Push flags ■ 

cmp 

al,3Fh 



Partial Disassembly of a Virus 

C/C++ and Pascal 

Some C. C++ and Pascal developers hate 
disassembly because the source code they get is 
assembly. We can't change that, but we can 
make it easier for you by automatically identi¬ 
fying the use of parameter passing and local 
stack variables. Parameters pushed onto the 
stack prior to a subroutine call are clearly com¬ 
mented. 

Get commented BIOS listings 

The BIOS Pre-Processor creates commented 
listings for any BIOS ROM. Understand how 
your specific BIOS works! Adds over 75K of 
comments specific to your BIOS. Inserts labels 
like "int_ 10_video". Andit's fully automatic. 

Windows disassembly! 

Windows Source generates detailed listings 
of Windows EXEs, DLLs, VxDs, device 
drivers, & OS/2 NE files. Windows Source 
labels, by name, export & import function calls, 
API calls like "GetModuleHandle”, undocu¬ 
mented APIs, VxD functions and much more. 

Call now! 
1 - 800 - 648-8266 

Sourcer $149.95 

Sourcer & BIOS Pre-processor 189.95 

Sourcer & Windows Source 249.95 

Sourcer, BIOS & Windows Source 289.95 

Shipping: USA $6; Canada/Mexico $10; All others $25. 

CA residents add sales tax. © 1994 VISA/MC/Amex/COD 

30-DAY MONEY-BACK GUARANTEE 
V Communications, Inc. 

4320 Stevens Creek Blvd., Suite 120-WD 
San Jose. CA 95129 408-296-4224 
FAX 408-296-4441 



It's 1:00 AM and a reader email leads me to an obscure Borland C/C++ bug — their import 
libraries refer to winspool .dll when they should refer to win spool .drv.It's so simple to describe 
and fix, I figure I'll be a good citizen and report it. But how? I hop up on their Web site and 
learn they want you to fill out a form. What a pain, but I would really like this fixed so I keep 
going. Then I find out you have to get a humongo PIN number from Borland before you can 
submit any bug. And of course, there's no one there to give me a PIN-head number at lam. AT 
Is it just me, or is this completely wacko? I cannot submit a bug that can be described utterly 
and completely in three sentences without jumping through all kinds of hoops, as though they 
are doing me a service by accepting my bug report! I'm sorry, but I'll start going to that much 
trouble to report a bug the day they start paying for them. And why shouldn't compiler ven¬ 
dors pay a bounty to the first person to report any particular bug? I dare any compiler vendor 
who thinks they really have a quality product (goodness knows they all make endless claims 
about how great their products are) to accept this challenge: start paying $20 per bug. I'll be 
first in line get my PIN-head number, or jump through whatever other hoops they've invent¬ 
ed to discourage bug reporting. Surely they can afford the cost, since they provide virtually no 
worthwhile free support anymore. AT As I write this, the Windows 95 version of the classic 
Petzold book has been announced. His initial book remained about the most detailed and 
broad treatment of basic Windows programming issues, but the Windows 3.1 revision was a 
disappointment, and contributed to creating a large group of programmers with the mistaken 
belief that they should stick to the medium memory model. Hopefully this version will be a 
strong rewrite that keeps the best of the old without including misleading sentiments that are 
no longer appropriate for Windows 95. AT Does anybody else out there work with multiple 
C/C++ compilers on a daily basis? If so, send me email and tell me what editor you use. I'm 
trying to motivate myself to switch to a Windows editor (I use DOS MicroEMACS), but most 
of them seem to expect you to have set up your environment variables for a single compiler 
before starting Windows (I use a batch file to dynamically switch between command-line com¬ 
pilers in DOS). AT If writing client/server code is in your future, check out this month's 
Understanding NT — it will show you how 1/O completion ports can help you keep just the 
right number of threads active. AT I had seen the argument before, but an article by Andrew 
Binstock in the April 1996 issue of Dr. Dobb's Journal convinced me that it really is time to start 
considering the slow speed of main memory relative to the CPU when designing modern 
implementations of classic algorithms, at least sometimes. AT Speaking of memory, the price 
of memory has supposedly started to budge, at least for the cheaper, slower varieties. It looks 
like 16Mb is going to soon be the accepted minimum configuration for a new Windows 95 
machine, which means it can tun NT just about as well. Does that mean NT's day is coming? I 
don't know, but I was surprised to find in our last reader survey that almost half our readers 
were developing mostly for Windows 3.1. About 20 percent were developing mostly for 
Windows 95, and about 15 percent were developing mostly for Windows NT (wondering what 
the other 15 percent were doing? Yup, DOS). I think we're looking at the worst possible sce¬ 
nario — you really need your code to work with all three versions of Windows, and they're just 
incompatible enough to make your life miserable. If you're feeling left behind because you still 
have to support Windows 3.1, it looks like you've got plenty of company! AT Interestingly, 
the same survey showed that about two-thirds of you have never downloaded any WDJ code, 
which means it's time again for me to tell you that every issue contains a list (see the table of 
contents page) of some of the many places you can grab our code for free. On CompuServe, go 
to forum SDFORUM and search Library 7 for "mmrnyy" (e.g., "APR95") to locate the code disk 
for a particular issue. From the Web, hop over to WWW. wd j . com. You can also FTP our stuff from 
the pub/windev directory at ftp.mfi.com. O 


Ron Burk 


Editor 

70302.2566@compuserve.com 


Drop In on our Web site! 
You'll find us at: 

http://www.wdj.com 


You’ll find information and excerpts from 
the current issue, along with links to WDJ 
code, including our SDK Annotations. 
Check it out — and let us know what you 
think. 
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Save months of TCP/IP programming! 


Fill in properties 




■ t I at 


Write a little code 




BEs ai wmmmmm K mmamm.- rara 

Object: Jcommandl Proc: j Click 


Private Sub Command1 Click() 


' Connect to the FTP Server 


FTPC1lent.Action “ ACTION CONNECT 


' Transfer Remote File to your machine 


FTPC1lent.FileAction - FILE ACTION GET 


End Sub 

zl 

Lu ±i 

% 


OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

• POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

•FTP 

• rlogin 

• TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

• 32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL's 

• C/C++ 

• OCX's 

• Access 

• VBX’s 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 



u 408.366.8933 

World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Not all intakes may be available for all protocols. Licensing fees required for redistribution. Distinct is a registered trademark and 30 minute Internet Delivery! and Visual Internet is a trademark of the Distinct Corporation. Copyright 1995 Distinct Corporation, 12900 Saratoga Avenue, Saratoga, CA 95070. All rights reserved. Specifications and delivery terms are subject to change without notice. 
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Visual Basic 


A Visual Basic 4.0 OCX for 
Spawning Processes 

Richard R. Sands 


=B3= 

Visual C++ v4.0 




Visual Basic 4.0 provides a 32-bit environment for creating Windows 95 or 
Windows NT applications, but as with previous versions of Visual Basic, not all fea¬ 
tures of the operating system are directly available. Fortunately, you can extend VB 
4.0 with OCXs, the 32-bit replacement for VBXs. In this article, I will describe an OCX 
I created that provides access to the Win32 API functions for creating threads and 
spawning processes. 

Introduction 

VB programs often spawn other programs to do some work on their behalf. You 
can always use the Windows API function Wi nExec() to start up another process; the 
tricky part has been how to detect when the spawned process terminated. Under 16- 
bit Windows, the most robust solution involved creating a DLL that used ToolHelp 
functions to detect process termination notifications from Windows. Under 32-bit 
Windows, the most robust solution requires the use of Win32 events. With an OCX, 
however, you can create a control that fires a standard Visual Basic event when the 
process terminates, and that is the approach I will take. 

For example, you might want to print a series of files by executing a separate pro¬ 
gram to perform the printing. After each file was printed, your application would 
provide another file. With a typical execute-and-wait routine, your VB program 
would sit idle, waiting for the print program to complete. With the OCX provided 
here, your VB program would continue to run normally (perhaps performing other 
useful work) until the print program notified VB with a "completed" event that 
would trigger the next file to be submitted. 

Creating a Process 

To perform the tasks outlined above, the control first needs to be able to execute a 
program and wait for it to terminate. With Windows 95 and NT, the most flexible and 
efficient way to execute another program is to use the Win32 API function 
CreateProcesst ). Both WinExecO and LoadModulet ) are implemented internally as 
calls to CreateProcesst). CreateProcesst ) allows both console and Windows applica¬ 
tions to be created and executed. As with Wi nExect ), it needs to have the filename of 
the program you want to run and any command-line arguments. You can also set ini¬ 
tial working directories, environment blocks, and, through the STARTUPINFO structure. 


Richard Sands has enjoyed programming in various languages for 15 years. He lives in 
Colorado where he currently crafts applications for System Innovations, an insurance 
software company. 
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Is your installer missing 
a few pieces? 



Don’t be puzzled, get Wise! 


The Wise Installation System 4.0 


The Wise Installation System is a Windows based installation editor that creates 
professional setup programs in hours, not days. It creates a single installation that runs in 
Windows 3. lx, Windows NT™ or Windows 95®. It comes complete with both Winl6 and 
Win32 versions, creates shortcuts/shell links for use with Windows 95, handles nested 
components and has a full uninstaller. It is completely customizable to fit your needs. 
Order now and stop looking for that missing piece! 



Business Solutions 




To order call 1 - 800 - 554-8565 
or use http://www.glbs.com 

to download a fully functional demo. 
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over a dozen window style attributes, 
including various subsets. 

Once a new process has been suc¬ 
cessfully started, CreateProcesst ) will 
fill out a PROCESS_INFORMATION structure 
with the new process and thread han¬ 
dles. The process handle is used to 
determine if the process is still active. 
This is accomplished by calling another 
API function, WaitForSingleObjectO, 
which waits for a specified amount of 
time for an object to be signaled. In this 
case, passing the new process handle 


HIGH-PERFORMANCE 

• high-throughput transaction model - 
supports group commit 

• asynchronous I/O 

• advanced query optimizer - supports 
clustered index 

• SMP-ready out of the box 

• efficiently manages multi-gigabytes 
of data 

HIGHLY SCALABLE 

• small footprint, runs comfortably on 
desktop and laptop machines 

• offers true client, server capabilities 
in workgroup environments 

• capable of supporting departmental 
applications requiring fast response time 


from CreateProcesst ) with a time-out 
of INFINITE will make 
WaitForSingleObjectO wait until the 
process has completed. Since it is wait¬ 
ing, execution is completely halted until 
WaitForSingleObjectO returns. This is 
where multithreading comes in handy. 

Multithreading 

The Windows 95 and NT APIs pro¬ 
vide support for multithreading appli¬ 
cations through two models of thread 
usage: worker threads and user inter¬ 


ADVANCED STORAGE MANAGEMENT 

• file-based schemas are easy to set up 
and maintain 

• device-based schema provide greater 
control over physical storage management 

• on-line backup 

• media recovery 

EASE-OF-USE 

• easy to install 

• self tuned. DBA not needed for 
workgroup applications 

CONFORMS TO STANDARDS 

• entry level ANSI SQL 92 

• an ODBC level 2 driver, serving as a native 
API to the Quadbase engine, is included 


face threads. Worker threads are back¬ 
ground processes with no user interac¬ 
tion; they are typically used to perform 
a single task repetitively, such as a long 
calculation or printing a document. 
User interface threads are more compli¬ 
cated, in that they usually are windows 
with their own message handlers and 
they are used in applications which 
require responding to events and mes¬ 
sages generated by the user. Since my 
task only needs to perform a 
WaitForSingleObjectO, the worker 
thread model fits the bill nicely. 

Creating a worker thread is pretty 
straightforward from MFC. You define 
a controlling function, that is, what you 
want to execute as another thread, with 
this prototype: 

UINT MyThreadProc( LPVOID pParam ); 

When you want to create the new 
thread to do the task, you just call the 
MFC function AfxCreateThreacK ) with 
that function's address and a pointer to 
whatever data you want to pass to the 
thread. The result is that you now have 
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To Our Subscribers 

Occasionally, Windows Developer's 
Journal makes its mailing list 
available to vendors of products 
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Prices start at $100. But don't be fooled by the low prices of Quadbase products. Quadbase-SQL 
offers many advanced features that are found (and not tound) in high priced products, e.g. bidirectional scroll 
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a second thread running in your appli¬ 
cation's address space. The fly in the 
ointment is that access to your applica¬ 
tion's data must be carefully synchro¬ 
nized. 

Process synchronization requires 
that you schedule access to variables 
and physical resources so that no two 
processes try to access them at the same 
time. Otherwise, what typically hap¬ 
pens is that two or more threads may 
try to access data at the same time, and 
if one is writing while one is reading, 
the results are very unpredicable. For 
this application I used Win32 events to 
block, or halt, execution of the parent 
thread until after the new thread had 
started, accessed the parent's data, and 
then signaled the parent thread to pro¬ 
ceed. 

Win32 events have two states: reset 
and signaled. When an event is reset, 
then some thread needs to use the 
WaitForSingleObjectt ) function to wait 
for it to become signaled in order to 
proceed. Another thread performs the 
signaling. You first create an event by 
calling CreateEventC ). There are two 
types of events, manual-reset and auto¬ 
reset. Manual-reset events are typically 
used when there are several threads 
that need to be synchronized, while 
auto-reset events are typically used 
with two threads. 

After the process has finished exe¬ 
cuting, the thread needs to notify the 
OCX that it's done. To do this, you can 
post a message via PostMessage () back 
to the OCX with the result of the thread: 
TRUE if the process finished executing or 
FALSE if the thread failed to create the 
process at all. Since it does not wait for 
the message to be handled, the thread 
terminates. As soon as the OCX 
processes the message, it fires an OLE 
event back to Visual Basic and the story 
repeats. 

Creating the OCX 

Creating the skeleton of an OCX 
with Microsoft Visual C++ 4.0 is like 
creating any other type of MFC pro¬ 
gram: I created a new project work¬ 
space and chose the OLE 
ControlWizard to guide me through 
creating the initial control. Like 
AppWizard, the ControlWizard 
prompted me through a few dialogs to 
get all the information. After the initial 


dialog that prompts for the path loca¬ 
tion of where I want to store the project, 
it starts out by asking how many con¬ 
trols this OCX will contain and if it 
requires code to handle a license file. 
Since this is the first control, I entered a 
value of one, and since this is a freely 
usable control, I chose no license files to 
be required. 

The next step in the wizard is to set 
the control's "features," which are 
shown as a group of checkboxes. In 
addition to the default checked options 


of "Activates when visible" and 
"Include About Box," I checked 
"Invisible at run-time," since this con¬ 
trol does not have a user interface. Also, 
although I did not initially include 
"Acts as a simple frame control," as it 
turns out, if I wanted my control to be 
able to receive posted messages, that 
needed to be checked. 

The wizard next displays the data it 
has gathered and generates the control 
class, property page class, resources, 
and four project configurations: debug 
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Compatible with Desqview and Windows. 
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Table 1 

events 

OCX properties, methods, and 

Properties 

AppPath 

Required 

The complete pathname of the 
program to be executed. 

ShowWindow 

Required 

A vbShowWindow constants 
defined in VB. Defaults to 
vbNormal. 

Arguments 

Optional. 

These are the command line 
arguments that you may want to 
include. 

StartupPath 

Optional. 

The directory where the program 
will be started in. 

Wait 

Optional. 

When true, this will block execu¬ 
tion until the task has completed. 

Methods 

IngID = Execute() 

Events 

Sub Completed(byval IngID as Long, byval blnSuccess as 
Boolean) 


and release versions of both an ANSI and a UNICODE build. 
At this point, I can begin to add my specific properties, meth¬ 
ods, and events to the control. 
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NEW RELEASE - 



WITH CLASS 3.0 



♦ Reverse C++, Delphi 

d -* * 
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♦ Import/Export C++ Code 

♦ Template driven Code and Report generation for 


State, Class and Object Interaction diagrams 
♦ Scripting interface to generate Custom Reports 


and Custom Code 


♦ Generate Code in C++, . )ia\5» , Delphi, Pascal, 
VFoxpro, Ada, SQL, VBasic and more 

♦ |OLE| support ♦ Error/Consistency Checking 

♦ Customize color and Fonts 

♦ Supports (Unified & all leading OOA/D methods 

♦ Prices: 32-Bit: $ 295 16-Bit: $ 195 Enterprise: $ 395 


♦ Tutorial: “0-0 Modeling, C++ Programming” 

♦ 7 Day Customer Service - SAME Day Delivery! 

Download latest demos: www.mi^®^|.com 

v.908.668.4779 e.71543.1172@cortiphserve.com 

f .908.668.4386 MICM60LB SOFTWARE. INC. 
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As with regular MFC programming, the ClassWizard is 
used to generate the source code entries for most of the class 
and resource components. To add the Application Path prop¬ 
erty, I first used ClassWizard to add the OLE-exposed proper¬ 
ty "AppPath" and a protected CString m_strAppPath class 
member. The default code for the properties is sufficient at this 
time. Next, in the resource file, I added an App Path edit con¬ 
trol to allow the user to edit the application path. Using 
ClassWizard, the code was generated to perform the data 
transfer to and from the member variable m_strAppPath. Last, I 
added the only actual coding that I had to do manually for this 
property — the support for data persistence in the 
DoPropExchanget ) function. This involved adding a 
PX_String( ), which handles the transfer between the OLE 
storage and the member variable. It also provides support for 
a default value when needed. This sequence of steps was per¬ 
formed for each property. 

After adding all the properties, I added a custom OLE 
Event called Fi reCompl eted(), which is code generated as an 
inline method that calls FireEventO with the specified para¬ 
meters. When the second thread notifies the OCX that the 
executed process has ended, it will post a message which will 
communicate this event to Visual Basic. Although there is no 
documentation that warns you not to fire off events from the 
worker thread to Visual Basic, doing so seems to generate 
GPFs. 

To support the second thread's notification of its termina¬ 
tion back to the OCX, I defined a message value by calling 
RegisterWindowMessagef ) and hand-coded the handler 
required to process the message. This just consisted of invok¬ 
ing the Fi reCompl eted () event. 

The bulk of the control is in the Execute! ) method (shown 
in Figure 1). A placeholder for the method was added with 
ClassWizard and code was then added to create a new thread 
to start the second process. To keep the function hidden from 
the rest of the program, I added the worker thread code as a 
method in the class, but I had to add the static function modi¬ 
fier so that the invisible "this" pointer wouldn't be passed to 
it, as would be the case with regular methods of a class. 


Figure 1 MFC implementation of the 
Execute method 


II Returns 0 if fails or non-zero (Handle) if successful thread, 
long CWDOExecCtrl::Executed 
{ 

// Halt for any threads to startup. 

WaitForSingleObject(m_hEventReady, INFINITE); 

m_lCount++; // Hake a new "handle". 

if (m_bWait) 

( 

// He're waiting, so just call the ShellThread method directly, 
if (ShellThread(this) — 1) 
return 0; 

) 

else 

1 

// Not waiting, so create a new thread and get it started. 
AfxBeginThread(Shell Thread, this); 

) 

return m_lCount; // Return the "handle" 
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Ultimate TCP/IP 

Client & Server TCP/IP Controls 

A comprehensive suite of C++ tools that make developing TCP/IP 
applications a snap. Covers all functions from low level packet calls 
right up to a single function call to make a WWW server! 


Easily create both client and server type applications. Includes 
code to easily turn your projects into Wir 
I lot ' 


i/indows NT services for a 
professional look and maximum performance. 


Build custom server applications in just minutes. Includes fully 
functional WWW, Finger, E-Mail and FTP server implementations. 
Just modify our sample code to get exactly what you want instantly. 

Our state-of-the-art multi-threaded design provides maximum 
performance and greatly simplifies the coding process. 

Using this library you can write a multi-threaded high performance 
NT server package in minutes. 

Integrates fully with MFC, OWL and SDK. 

Pricing: $199.00 / with source $499.00 



The Ultimate Grid™ Control! 


Communication Center 



Type 

Date 

Name 

Print 

Priority 


1 

FI 

02/12/95 

Adam Seibel 

Print Now 

Urgent 

g 

2 

tr 

02/12/95 

Craig High 

✓ 

Low 


3 

HP 

02/13/95 

Dave Cunningham 

✓ 

Normal 


4 

is* 

02/14/95 

Doug Keller 

Print Now | 

Urgent 


5 

FI 

02/18/95 

Andrew Whitman 

✓ 

Urgent 


6 

^3* 

02/21/95 

Ed Chong 

✓ 

Normal 


7 

r=i 

02/24/95 

Julie Ind 

✓ 

Low 


e 

ED 

03/01/95 

Joe MacIntyre 

Print Now ] 

Urgent 


9 

HP 

03/05/95 

Laurie Hay 

Print Now 

Normal 


10 


03/05/95 

Troy Marchand 


Normal 


11 

r«-j 

03/11/95 

Lorraine Weiler 

Print Now: 

Normal 


12 


03/19/95 

Victor Lau 

✓ 

Urgent 

d 


Loading Message Data 


An easy to use and very powerful grid tool that includes both 16 and 32 bit 
versions in one package. 

Works seamlessly with ODBC, BDE, standard databases, custom data files, 
memory arrays, memory mapped files, text files and more! Allows multiple 
datasources per grid, calculated fields and the display of real time data. 

Multiple class libraries work with MFC, OWL, the SDK and other framework 
products. One product covers all the bases. 

You will never outgrow the Ultimate Grid! It supports over 2 Billion rows, 32 
Thousand columns, custom cell styles and owner draw. You can even extend 
it's capabilities. You can override tne built-in edit control to get the EXACT look 
and feel you want. 

All arid properties can be changed on-the-fly. Adjust the number of columns 
and/or rows, change individual cell styles, etc., etc. 


Features galore! Inline masked editing, drag and drop, multiple text styles, 
bitmaps, check boxes, multiple selection, drop lists, multiple column sizing 
options. Other custom styles are also included. 

Includes comprehensive source code examples and demonstration code so 
you can get started right away. 

Pricing: $149.00 / with source $349.00 


The Ultimate Effects™ Control 

Create stunning visual effects in your applications using this amazing product! 

Includes more than 30 border/panel styles, including raised, recessed, gutter, bump, 
patterned, gradiant fills and more. 

Create plain or 3D text effects and have the text filled with plain colors, gradient fills, or 
for an amazing effect use a bitmap as the text color. 

Check our WWW site for visual examples of what this product can do! 

Pricing: $59.00 / with source $159.00 





Status 

Priority 

Job 

95.12.00 

✓ 

Active 

Maximum 

Data Entry 

95.12 01 

✓ 

Active 

Med 

Calander 

95 12 02 

X 

On Hold 

High 

Invoicing 

95.12.03 

Finished 

Maximum 

Data Analysis 1 

95.12.04 

✓ 

Active 

^ 1 * 

Log Viewer | 

95.12 05 

X 

On Hold 

Maximum 

Customer List | 

95 12 06 

X 

Cancel 

High 

Med J 

Data Viewer 1 

95.12.07 

✓ 

Active 

P.I.M. 

95 12 08 

✓ 

Active 

muTT 

List Box 

95.12 09 

X 

Cancel 

Low 

Real Time Data | 

d r 


DUNDAS 


SOFTWARE 


sales@dundas.com 
Sales: (800) 463-1492 
Voice: (416) 239-7472 
Fax: (416)239-2183 


Money back guarantee. If you don't think these products 
are the best in their class, we will gladly give you your 
money back. 

Call Today! Visa, Amex, cheque or money order. 

We will deliver via internet, CompuServe, mail or courier. 
The prices shown are in U.S. dollars. 



202-4800 Dundas Street West 
Etobicoke, Ontario M9A 1B1 


240 Portage Rd., Suite 670 
Lewiston, NY 14092 
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Figure 2 Helper function to call CreateProcessQ 

iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiniiiiiiiiiiiiiiiiiiiii 

si. 1pReserved2 - NULL; 

II Shell Process Worker Thread. 

si.cbReserved2 - 0; 

UINT CWDJExecCtrl::ShellThread(LPVOID pParam) 

si. 1pDesktop - NULL; 

( 

si.dwFlags - STARTF USESHOWWIND0W; // this enables wShowWindow 

CWDJExecCtrl *pObject - (CWDJExecCtrl *) pParam; 

si.wShowNindow - pObject->m_iShowWindow; 

if (pObject — NULL || 

if (CreateProcess( NULL, 

!p0bject->IsKind0f(RUNTIME CLASSICWDJExecCtrl))) 

strCommandLine.GetBuffer(l). 

return 1; // Thread fails: illegal parameter 

NULL, 


NULL, 

CString strCommandLine; 

TRUE. 

LPTSTR IpStartupPath - NULL; 

NORMAL PRIORITY CLASS, 

long 1ExecID - pObject->m ICount; 

NULL, 


IpStartupPath, 

SetEventC pObject->m_hEventReady); 

&si, 


Ipi )) 

// Cat the command line and the arguments into a single string. 

{ 

strCommandLine - pObject->m strAppPath; 

WaitForSingle0bject(pi.hProcess, INFINITE); 

if (!pObject->m strArguments.IsEmptyO) 

CloseHandle(pi.hProcess); 

strCommandLine +- " ” + pObject->m strArguments; 

CloseHandle(pi.hThread); 


pObject->PostMessage(nCompletedMessage, TRUE, 1ExecID); 

// Send the starting directory or NULL if it's empty. 

return 0; // Thread Success! 

if (!p0bject->m strStartupPath.IsEmptyC)) 

} 

IpStartupPath - pObject->m_strStartupPath.GetBuffer(1); 

else 

STARTUPINFO si - {0}; 

i 

pObject->PostMessage(nCompletedMessage, FALSE, 0); 

PROCESS_INFORMATION pi - {0}; 

return 1; // Thread Failed. 

si.cb - sizeof(STARTUPINFO); 

} 

si.IpReserved = NULL; 



ShellExecuteO, the function that actually calls trol, such as editing the "About" dialog and creating the 
CreateProcess(), is shown in Figure 2. bitmap to display on the Visual Basic form while in design 

Some other minor tasks were required to finish the con- mode. To draw the bitmap, I needed to override the OnDrawt) 


SuperMonitor 
for DOS, Windows 

The flexible and versatile solution for your serial data and protocol analysis. 
The continous graphic user interface for DOS and Windows* guarantees an 
easy operation. SuperMonitor is very quickly attached to a serial data 
transmission and is a silent but watchful observer of the operation. 

You are now able to considerably reduce 
your development time and costs when 
setting up or monitoring a serial link by 
using SuperMonitor. 

SuperMonitor is able to execute not only 
simple short measurements but also long 
day and night runs. In Windows 3.x up to 
two measurements can run 
simultaneously using the Twin version. 

You even have the possibility as 
developer to extend SuperMonitor by 
using SuperCom the heart of SuperMonitor. 
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• flexible software solution 

• up to 115 KBit baud rate 

• parity: none, even, odd, mark, space 

• stop bits: 1,1.5,2 

• data bits: 5,6,7,8 

• time stamps with a precision of 10 ns 

• display of all modem lines 

• dynamic trigger function 

• extensive display, print and search functions 

• limited buffer only through the PC memory 

• data swap-out for long day and night runs 

• display modes: ASCII, Decimal, Hexadecimal 

• up to two simultaneously running measurements in Windows 

• IRQ0..IRQ15 and any port address 

• includes special adapter, cabel and 16bit serial board 


SuperMonitor for DOS only $398 
SuperMonitor for Windows only $498 
SuperMonitor for DOS+Windows only $768 
SuperMonitor for Windows Twin only $748 
SuperMonitor for DOS+Windows Twin only $998 

’Windows=Windows 3.x + Windows 95 
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Micro-Software 


RS232-Toolkit, SuperCom for 


ipe 

DOS, Windows, OS/2, NT, WIN 95 

for MS C/C++, Visual C++, Turbo/Borland C/C++, 
Turbo/Borland Pascal Delphi, IBM C/C++, WATCOM C/C++ 

SuperCom is the development tool for exacting serial communication 
software. That means high data security and highest transmission speed. The 
SuperCom libraries are fast even in a multitasking operating system like 
Windows 3.x, NT, Windows 95 or OS/2. The same programming interface is 
used among different languages and operating systems. 

• Interrupt driven: transmission, reception, linestatus, • Language independent DLL (Windows, NT, WIN95, 

modem status. Up to 115,200 bps. OS/2) which can be used for simultaneous transfers 

• UARTS: 8250,16450,16550 FIFO, any port address, by applications. 

• Simultaneous COM_1 ,.COM_36 (and unlimited). • Multiserial board support (AST, ARNET, DigiBoard 

• Direct register programming*. Interrupt-Sharing. PC/X, HOSTESS, STARGATE). Reduces loading of 

• Flow control: RTS/CTS, DTR/DSR, XON/XOFF and CPU through support of intelligent DigiBoard PC/Xe, 


user defined. ANSI, TTY, VT52. 

• Protocols: ASCII, XMODEM, XMODEM/CRC, 
YMODEM, YMODEM/BATCH, ZMODEM. 

• Timer, Ctrl-Break and Exception handling. 

• Multitasking support (Windows, NT, WIN95, OS/2) 

• User Event Routines under DOS and Windows. 

• Under Windows user can even post messages to 
the application using PostMessage. 


PC/Xem, PC/Xi boards (up to 7 Boards/PC III). 

• Modem support, RS422/485 support. 

• Supports 286 DOS-Extender (e.g. PharLap, Borland) 

• NO ROYALTIES. No resident drivers*. Just link the LIB. 

• FREE technical support. FREE demo 

• Full source code (C or Pascal and optimized ASM). 

• SuperCom++ (C++ or Pascal OOP) included. 

• Protected Mode Interface (Windows) included. 


C/C++ or Pascal package for DOS only $299 
C/C++ or Pascal package for Windows. OS/2 or NT each $399 
C/C++ or Pascal combo pack for DOS+Windows only $528 
C/C++ combo pack for DOS+Windows+OS/2 only $799 
C/C++ combo pack for DOS+Windows+NT only $799 
C/C++ combo pack for DOS+Windows+OS/2+NT only $999 
'Under DOS and Windows. Windows=Windows 3.x + Windows 9516bit, 

NT=Windows NT + Windows 95 32bit VISA MC COD 



NEW!!! COMM-Enhancer for Windows 3.x 

Forget the Windows 3.x COMM API limitations. Use the COMM-Enhancer and extend 
your Windows 3.x COMM API based applications. Up to 40 channels (COM1...COM40!) 
and up to 115.200 bps. It uses SuperCom 3!!! 

Price $299 (together with any SuperCom combo supporting Windows 3.x $199!) 


ADONTEC Computer Systems Ltd 

Hoelderlinstr. 32 

D-75433 Maulbronn, Germany 

Phone: +49-7043-9000-20 
FAX: +49-7043-9000-21 


Fine Line International 
7000 Malone Rd, Forestville 
CA 95436. USA 

Phone: +1-707-887-3400 
FAX: +1-707-887-1015 


In Israel, call: 

Phone: +972-3-924-3555 
FAX: +972-3-924-3132 

In Italy, call: 

Phone: +39-49-8713444 
FAX: +39-49-8713055 
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The 

winning 
edge 
on your 
DOS and 
Windows 
apps 



The National Software Testing Lab (NSTL) can get you in great position on the 
field. For a limited time, IBM® makes it possible for solu tion providers to take 
advantage of free testing of any software product available for resale to evaluate 
its compatibility with OS/2 Warp. You’ll also get free technical support through 
1996, plus publicity on the Internet! 

Call no w to schedule your free product compa t ibility testing. With NSTL 
coaching, the other guys wont be able to touch you. 


With NSTL 
compatibility 
testing on 
your side, 
you’re not just 
playing, 
you’re winning. 


Look for the NSTL Tested mark on these applications: 


American Computer Software, Inc.’s Computerized Property Management™ 

BDL Homeware’s™ BDL Sched-C™ 

Business Systems of America, Inc.’s ORDERS Plus™ - Business Automation 
Carbon Based Softwares Zipstream™ 

CEO Software, Inc.’s Optimum Settings 

Cheyenne Software, Inc.’s ARCsolo® OS/2 

Common Ground Software Inc.’s Common Ground™ for Windows 

Cougar Mountain Software’s ACTPIus* 

C. Alexander & Associates, Inc.’s Affirmative Action Plan Software 

Datalex’s Entrypoint for Windows 

Education Software Consultants’ BASIC COMPOSER™ 

Epistat Services’ Readv-or-Not (DOS) 

Eureka Software’s™ Great Bears of North America 
E.M.M.E. US' Michelangelo 
Gemcom Services, Inc.s GS32 
Greenleaf Software*, Inc.’s Comm-H- Library’ 

Hilgraeve, Inc.’s Kopy Kat 
ID Innovations, Inc’s AnyLabel™ 

Information Radio Technology, Inc.’s AlphaPage® for Windows 


ITC Integrated Systems, Inc.’s Toolware Deluxe™ 

Lestec Pty Ltd’s Modular and Integrated Design 
LMR International, Inc.’s My Bank™ 

Maplnfo Corportation’s Maplnfo Professional™ 
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method, add the code to load the bitmap from the resource 
file, and render the bitmap using the CPictureHolder class. 
The CPi ctureHol der class is normally used to provide support 
for stock picture properties and provides a nice high-level tool 
for bitmap rendering. After compiling and linking, the control 
was ready to use. 


Using the OCX 

You use this OCX as you would any other. After you have 
added it to your toolbox via the Tools Custom Controls menu, 
you can drag an instance of the control to the form where you 
want to use it. You can set the initial properties through the 
property sheet or directly in the form's code. When you want 
the second program to execute, you call the control's execute 
method. After the second program has finished executing, any 
code that is contained in the Compl eted () event will get execut¬ 
ed. Table 1 summarizes the control's properties along with its 
single method and event. 

Since an ID is returned from the execute method, this con¬ 
trol will allow multiple processes to be executed. The caveat 
here is that if you are displaying a modal dialog when a com¬ 
pleted event fires, that event will be lost. 

Summary 

The code disk (see Table of Contents for availability) con¬ 
tains a sample VB program (see Figure 3) that demostrates 
how to use the WDJExec control. With it, you can set the prop¬ 
erties at runtime to test out the control. I added a "Count" 
field to launch several instances of the shelled program in 
order to stress-test the synchronized generation of the IDs 
returned from the execute method. As this example shows, an 
OCX can make Win32 features such as threads and events 
easy to use from within VB 4. □ 
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An Automated Makefile Maker 


Betsy A. Gamrat 
Burke, VA 

Maintaining accurate dependency lists for makefiles is important when you are 
developing projects with many interdependent source files. This article presents a 
simple scheme to automate the creation and maintenance of makefiles for C projects. 
The method may be applied to many other languages. 

A makefile describes the file dependencies and the compilation commands. This 
application uses a skeleton makefile to declare implicit rules to specify the compiler 
and linker commands for the project and to include the dependency list. 
Dissociating the commands from the dependencies makes it easy to update both 
independently. 

The manual process of maintaining a dependency list is tedious, but straightfor¬ 
ward. Search the file for #i ncl ude directives, and add them to the dependency list. 
The source code, i ncl ude.C (Listing 1), does exactly that. 

The code makes certain assumptions. It assumes that all the files in the current 
directory are part of the project, and that there are no dependencies on files in other 
directories. The next assumption is more subtle. #i nclude directives may use two 
types of filename enclosures, those enclosed in angle brackets and those enclosed in 



Leor Zolman is a consultant specializing in C programming training, an instructor on 
UNIX topics for Boston University’s Center for Information Technology, and "Tech Tips" 
editor for Windows Developer's Journal. His book, Illustrated C, was published in 1992. 
He may be contacted at 74 Marblehead St., North Reading, MA 01864. Internet address: 
leor@bdsoft.com. 
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Listing 1 include, c 


int get_dependencies (char ‘filename) 

{ 

/* 

* Searches C source file for (/include directives with " 

* (quotes) as delimiters. 

* Don't run INCLUDE on itself. 

*/ 

char *objfi1ename, ‘objext; 
char ‘inline, *ptr; 

FILE ‘infile; 


double quotes. The compiler's pre¬ 
processor searches the local directory 
first for double-quote-delimited head¬ 
er files, making these a likely choice 
for project header files. This is impor¬ 
tant in that it avoids unnecessary 
dependencies on header files that 
rarely change (such as those supplied 
with the compiler). The program only 
records dependencies specified with 
double-quoted #i ncl ude directives. 

Another tool, objl ist.c (Listing 2), 
creates a list of the object files to be 
linked into the project. For every .c 
file in the directory, an . obj file is 
named. 

To build a makefile for a project, 
run 

INCLUDE > deplist 

to create the dependency list. Next, run 

OBJLIST modeljetter > objlist 

where model_1 etter is the single-letter 
designation of one of the standard 
memory models (t, s, c, m,l, or h), to cre¬ 
ate both the list of object files and a file 
named LIBLIST, which contains the 
names of any additional libraries to 
scan. Finally, edit the makefile (Listing 
3), assigning the PROJECT macro, speci¬ 
fying the correct touch, compiler, and 
linker commands and options. 

Dividing the makefile and 
automating the dependency list gener¬ 
ation can save a tremendous amount 
of time and effort, especially on large 
projects with many engineers. 
Enhancing the program with a search 
function would allow it to support 
more complex development environ¬ 
ments. 
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/* include.c */ 

/* Builds a dependency list */ 

(/include <dir.h> 

(/include <dos.h> 

(/include <stdio.h> 

(/include <string.h> 

(/define FALSE 0 
(/define TRUE 1 

unsigned long totaljines - 0; 

char buffer[132],buffer2[18], buffer3[6]; 
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Listing 1 continued 


unsigned int lines - 0; 

inline - &buffer[0]; 

Int dependencies - 0; 

fgets (inline,131,infile); 

int header_fi1e; 

//define delimiters 

/* If this line has an include directive */ 
if (strstr (inline,"//include") I- NULL) 

{ 

/* Extract the filename from the directive */ 

if ((infile - fopen (filename,"rt")) != NULL) 

{ 

strtok (inline,delimiters); 

/* Create the target file name */ 

ptr - strtok (NULL,delimiters); 

objfi1ename = &buffer2[0]: 
objext = &buffer3[0]; 

/* Add the dependency to the list */ 

objfi 1 ename - strcpy (objfi 1 enatne,filename); 

if (ptr != NULL) 

if (strstr(f11ename,".C") I- NULL) 

{ 

{ 

printf (" \\\n\t\t%s",ptr); 

strcpy(objext,".obj"); 

dependencies++; 

header file - FALSE; 

} 

else 

) 

} 

if (strlen (inline) > 0) 

{ 

lines++; 

strcpy(objext,".h"): 

} 

header file - TRUE; 

} 

objfi1ename - strcat (strtok (objfilename,"."),objext); 

fclose (infile); 

/* Use touch to update the timestamp on dependent header files */ 

printf ("%s:",objfi1ename); 

if ((header file — TRUE) && (dependencies > 0)) 

/* Avoid circular dependencies for header files */ 
if (header file — FALSE) 

printf (" \n\t\t$(T0UCH)"); 

/* Print the number of lines read */ 

printf ("\Us",filename); 

printf ("\n// (Xu Lines)\n",lines); 

/* Read the source file */ 

total lines +- lines; 

) 

while (!feof(infi1e)) 

else 

{ 

puts ("Unable to open file"); 
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Listing 1 continued 


return dependencies; 

} 

void main (void) 

{ 

char buffer[132], ‘filename; 
struct ffblk ffblk; 
int done; 
int i; 

unsigned total_files - 0; 
filename - {.buffer [0]; 

printf ("# Dependency list generated by INCLUDE\n\n"); 

/* List the highest level of dependency, */ 

/* the executeable and objects. */ 

totaljfiles - 0; 

printf ("{(PROJECT).exe :\t"); 

strcpy (filename,"*.c"); 

done - findfirst (filename,&ffblk,0); 

while Udone) 

{ 

printf CT*s. obj ".done - strlen(&ffblk.ff_name[0])- 
2,ffblk.ff_name); 

done - findnext (&ffblk); 
if (idone) 

printf (" \\\n\t\t"); 

} 

printf ("\n\t\t$(LINKCMD)\n\n"); 

for (i - 0; i < 2; 1++) 

{ 

switch (i) 

{ 

case 0; 

/* Get the C file dependencies */ 
strcpy (filename,"*.c"); 
break; 
case 1: 

/* Get the header file dependencies */ 

strcpy (filename,"*.h"); 

break; 

) 

done - findfirst (filename,&ffblk,0); 
while Udone) 

{ 

total_files++; 

get_dependencies (ffblk.ff_name); 

printf ("\n”); 

done - findnext (Affblk); 

} 

} 

printf ("# (%u Files)\n",total_files); 

printf ("# (XI u Total Lines)\n\n”,total_lines); 

return; 

} 

/* End of File */ 


Listing 2 objlist.c 


* objlist.c */ 

/* Lists object files to be linked (one for every .C file) */ 
/* usage; objlist memory_code > ojblist */ 

#include <dir.h> 

#include <dos.h> 
ilfincl ude <stdio.h> 

#include (string.h> 


Listing 2 continued 


char bufl [132], buf2 [132]; 

void main (int argc.char *argv[]) 

{ 

char ‘filename, ‘model; 
struct ffblk ffblk; 
int done; 

filename - &buf1 [0]; 
model - &buf2 [0]; 

/* 

* Many compilers require an initialization or library module. 

* Refer to the compiler documentation. 

*/ 

if (argc < 2) 

{ 

printf ("Enter memory model (t.s.c.m.l ,h): "); 
gets (model); 

) 

else 

strcpy (model,argv[l]); 

printf ("WturbocWlibUcOXlc.obj +\n",‘model); 

/* Search the directory for .C files, */ 

/* add an .OBJ entry for each one */ 

strcpy (filename,"*.c"); 

done - findfirst (filename,&ffblk,0): 

while Udone) 

{ 

printf ("%.*s.obj",strlen(&ffblk.ff_name[0])-2,ffblk.ff_name); 
done - findnext (&ffblk); 
if Udone) 
printf (" +\n"); 

) 

printf ("\n"); 

} 

/* End of File */ 


Listing 3 makefile 


# Makefile template 

# Project name is target .EXE filename 
PROJECT - DEMO 

# Touch macro is used to update dependent header files to force 

# recompilation of dependent .C files 
TOUCH - touch $*.h 

# Compiler command and options 
CC - tcc 

CFLAGS - -c 

# Linker command and options 
LD - tlink 

LDFLAGS - /v /c /d 

# Linker command 

# objlist is the list of object files to be linked 

# 1iblist is the list of library files to be referenced 
LINKCMD - $(LD) {(LDFLAGS) @objlist,.\((PROJECT).EXE,,@liblist 

t Implicit rule for compilation 
.c.OBJ: 

((CC) ((CFLAGS) (*.c 

# Include directive for dependency list 
!include "deplist" 
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A Token Parsing Function for C++ This version is specific to Borland C++; since the Borland 

class library uses reference counting for strings, there are no 
extra string copies made. 

The idea should be relatively easy to port to MSVC as 
well. □ 

Piotr Markiewicz 
piotr@homer.iinf.gliwice.edu.pl 


C has a very nice function named strtokO for parsing 
strings into tokens. This function is not integrated into the 
C++ string class hierarchy, however, so I created something 
similar that is. You'll find the source in cstrtok.cpp (Listing 4) 
and CStrtok.h (Listing 5). 


Listing 4 cstrtok.cpp 


// 

// cstrtok.cpp: strtok-like function for C++ 

// (with a test driver) 

II 

/(define TEST 
/(include "cstrtok.h" 

TStringToken::TStringToken (const string& si, const string^ s2) : 
TArraykstring> (0, 1, 1) { 

size_t Last_Pos - sl.find_first_not_of (s2); 
if (Last_Pos !- NPOS) 

1 

size_t Curr_Pos - sl.find_first_of (s2, Last_Pos); 

while (Curr_Pos !- NPOS) 

{ 

Add (string (sl.substr (Last_Pos, Curr_Pos - Last_Pos))); 
Last_Pos - sl.find_first_not_of (s2, Curr_Pos); 

Curr_Pos - sl.find_first_of (s2. Last_Pos); 

1 

if (Last_Pos < si.length 0) 

Add (string (sl.substr (Last_Pos))); 

1 

1 

/(ifdef TEST 

/(include <iostream.h> 

void 
main 0 
1 

TStringToken s ("Mary has, , a very little lamb", " ,"); 
TStri ngToken b ("Now Mary has, , a very big elephant ", " ,"); 
TStringTokenlterator i (s): 

TStringTokenlterator j (b): 

while (i) 

{ 

cout « 'I' « i.Current () « '|' « endl; 
i++; 

1 

while (j) 

1 

cout « 'I' « j.Current 0 « '|' « endl: 
j++: 

1 

1 

/(endif 

//End of File 


Listing 5 cstrtok.h 


/(ifndef _CSTRTOK_H_ 

/(define _CSTRTOK_H_ 

/(include <cstring.h> 

/(include <classlib\arrays.h> 

class TStringToken : public TArraykstring> 

1 

public: 

TStringToken (const strings si, const strings s2); 

1 : 

typedef TArrayIterator<string> TStringTokenlterator; 
/(endif 

/* End of File */ 
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Visual Basic 


Translating Visual Basic 4.0 
System Color Constants 

Ray Wasilewski 


white 

lavender 



green 

red 



One of the Microsoft "magnificent seven" requirements for Windows 95 logo 
certification is the use of system colors. Visual Basic 4.0 includes 25 defined sys¬ 
tem color constants that enable programs to inherit the user's desktop color 
scheme (e.g., vbWindowText, vbWindowBackground, vbButtonFace, and so on). These 
constants work well for color assignments within VB, but programs that pass 
these color property values directly to DLLs or the Windows API will not function 
properly. 

A Visual Demonstration 

When you read a color property in VB 4 you can no longer assume that the 
returned value is an RGB value. To demonstrate the problem, create a project with 
one module and a form that contains a command button. Put the API declarations 
from Figure 1 in the module's declarations section. If you have not used the API 
viewer included with VB 4, this would be a good time to try it out and save some 
typing. Watch out for incorrect library specifications for Fill RectO, 
GetCl ientRectf ), and Inf 1 ateRectf ) in the 16-bit version. My Win31 API viewer file 
has these User functions defined as GDI calls. 

(text continued on page 29) 
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or 312-465-3559. _ 
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SftTree/OCX Tree Control 


File Name 

Description 


l 

JF 

□ 

•V Project NEWAPP MAX 


“ 

EX 

! P about c 

| Easily edit tree daltj 

11 




aPPh 

Using any control (combo, edit... 1 


4429 chats 


i < 

J® editmdi.c 

SC] editmdi h 

Text Edit Window (MDI Chid) 

Old MDI edit cMd window, needs chanae 

16449 chars 



Text Edit MDI CMd Definitioni 

RTF control API 


88129 chars 



kQ <window*.h> 

Window* Header File 


151579 chats 

I 



See our Web pages 
for a complete list of 
features and to 
download a demo! 


From simple listbox with bitmaps to multi-line, multi-column, hierarchical data display, 
SftTree delivers! Available as a DLL based control and now also as an OLE control. 
Our new OCX version supports all popular environments including VB, Delphi, Access, 
etc. Use the DLL version with C, C++ (MFC, OWL) and other DLL-call capable 
languages (see our other ads in this magazine). 


MmML i mu 

Not The Industry Standard 

11 Michigan Ave 
Wharton, NJ 07885 


Call today 
for your 
free demo! 


(201) 366-9618 
FAX (201)366-3984 
BBS (201) 366-3940 

http://www.softelvdm.com 


Instant ly Search 100s 
of Megabytes 

of Text or Source Code! 

, lndu$tTtal-strength...superb’ -pc Magazine 

Search instantly through the text of 
1000s of word processing, ZIP, OLE 2, 
DBF and other files. • Relevancy- 
ranked natural language, fuzzy, 
phonic, Boolean, wildcard, 
proximity, field and numeric range search options. 

• Searches with or without a search index; unlimited 
capacity. (The 32-bit version can index over 10 
MB/min. Indexed searches usually take less than a 
second.) • Built-in graphics viewer. 

1-800-n-FIIVDS www.dtsearch.com 

dtSearch 4,0 for Win 95/ NT (32-bit) $199 (LAN 5 $800) 

Instantly Search Your File Cabinet 

dtSearch 4.0 and Xerox® TextBridge® 

OCR (Class ic) integrated bundle $274 

Morton Navigator™ users: Ask about 
our dtSearch Find Plus™ add-on! 

DEViLOPiRS; Add dtSearch's proven text 
retrieval engine to your product! 

Commercial software incorporating dtSearch’s 
32-bit DLL is in use on hundreds of thousands of 
computers around the world. OLE Automation 
option. 32-bit DLL for: • 1 to 5 concurrent users on 
a LAN, Internet server, etc. $1,000 • up to 250 
machines (some restrictions apply) $5,000. 

Also available Electronic Publisher’s Toolkit. 



DT Software, Inc. 703/413-3670 fax 703/413-3473 


j Request Reader Service #116; 





VB/CodeReview^ 

Quality Assurance for Serious Developers 


Calling All Known Bugs... 


VB/CodeReview automatically reviews your 
Visual Basic projects for hundreds of potentially 
fatal bugs and conditions and then advises you 
how to avoid them all! Just point to your pro¬ 
ject and let VB/CodeReview show you all the 
things that can make your project misbehave! 
It's like having a whole team of VB gurus 
performing code review on your project! 
VB/CodeReview shows you how to make 
your code better, faster, smaller and bug- 
free! It's the ultimate quality tool, and the only 
LINT for Visual Basic®. 


All Known Bugs 


VB/CodeReview can spot hundreds of condi¬ 
tions, including all known custom control, Visual 
Basic, Windows™and 3rd party tool bugs listed 
in its exclusive bugbase. 


Quality Control Anybody? 


VB/CodeReview also knows all about the things 
that can make your apps difficult to use, hard to 
maintain, slow and bloated. VB/CodeReview 
spots nonstandard naming and GUI objects. It 
even spots those embarrassing "fat fingers”- 
you know, those dumb things like Stops, Ends 
and Resumes that get left in your code and wind 
up causing tech support calls. 


You Know You Need This! 


VB/CodeReview will find all known bugs in 
your projects—or your money back. So what 
are you waiting for? You need this! Go get 
VB/CodeReview right now! 

VB/CodeReview Features 

VB/CodeReview finds these and other bugs 
in your project. It finds all known... 

• Custom Control Bugs (OCXs, VBXs & 
DLLs, including usage and portability 
issues) 

• Visual Basic Bugs (Covers runtime and 
design time issues, Including VB 3 & 4) 

• Data Access Bugs (Data Control, 

Bound Controls, DAO, Jet, ODBC) 

• Windows API Bugs (Win 3.x, NT, 95) 

• 3rd Party Bugs (Popular 3rd Party Controls) 


VB/CodeReview knows all about these and 

other common and fatal conditions... 

• Logic Errors — recursion, type mis¬ 
matches, loops and more 

• Portability Issues — conditions limiting 
project to certain VB or Windows 
versions 

• Performance — common mistakes & 
conditions that reduce execution speed 
and bloat code 

• Standards — spots non-compliant 
naming and user interface objects 

• Usability — duplicate accelerator keys, 
missing accelerators, missing help, 
mnemonics & much more 

• Guffaws — Ends, Stops, Resumes and 
other common and fatal mistakes 


CALL NOW 1-800-818-1611 


Marquis V/B Code Review—It Knows 5 " 

Marquis V/B Code Review for Visual Basic...only $179.95 
Your Ticket to Better, Faster, Smaller, Bus-Free Code 

Money Back Guarantee • Free Demo from VBPJPO on CIS 
Marquis Computing, Inc. P.O. Box 387 Pomfret Center, CT 06259 
Tel: 860-963-7065 • Fax: 860-928-7727 • Email: lnfo@MarquisTools.Com 
HTTP://www.MarquisTools.Com 
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Visual Basic Tool Showcase 




NO C OR SDK REQUIRED! 


Create component objects with Visual Basic. 


Creates the true Windows DLL interface. This means 
applications can use the DLL API inter face to call 
your Visual Basic functions! 

Split up large Visual Basic apps into smaller more 
manageable components. 

Create call-back procedures! Create File Manager 
extensions! Create add-on’s and Wizards! Create 
Control Panel “applets”! 


Automatically generates C header 
files and Basic Declare statments. 


“Visual DLL does the near-impossible, turning Visual Basic 
code into a true DLL. creating classes of applications previ¬ 
ously beyond Visual Basics reach" 

-Windows Sources, 

July 1995 



"Creating a DLL with Visual DLL is a surprisingly simple 
process. You can create DLL's callable from any language. 
It's easy, fun and fast!" 


-VB Tech Journal, 
June 1995 



Visual 


« 1995 SIMflY SOamONS SORWAKE DEVELOPMENT CO*® 


FOR WINDOWS 


AutoCAD DWG Viewer VBX, OCX 

AcademusView VBX/OCX 
views AutoCAD DWG files fast 
and easy. Now includes 
support for R13 with optional 
preview.Features includes 
linetypes, solids, fonts, attribs, 
x-refs, and much more. Only 
$99/$199 (no royalties). 

AcademusView VBX/OCX PRO 
version offers functionality 
such as full zoom, pan, print, 
clip. Just $1499/$1999 (no 
royalties). 


», w i sr^rir rl - m 
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. 
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Academus AS 

Olaf Helsetsvei 6 
Boks 70, Bogerud 
N-0270 OSLO, NORWAY 

Phn: +47 22627300 Fax: +47 22835990 
E-mail: academus@academus.no 
Home page http://riksnett.no/academus/acade.html 
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Internet VBX/OCXs 

Web Browser Control 
Image viewer, FTP, Telnet, SMTP, POP3, DNS, 
Ping, RLIB and SocketWrench/VB. 

I* Includes VBX+32-bit OCX components • BMP/PCX/GIF/JPEG/XBM rendering 
[• Develop Intemet/lntranet applications • Compliant to HTML 2.0, some 3.0 
?• Build custom client and server apps • Samples are complete Internet apps 
• Use with Visual Basic 3.Q/4.0 and ALL WINSOCK compliant TCP/IP products 

! All this and NO ROYALTIES -- Only S247 + 90 day money back guarantee. 
SocketTools ™ by Catalyst Development 
sales@catalyst.com • 800/776-3818 • 619/228-9653 ext.WD 
I_ http://www. catalyst, com 
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HELP MAGICIAN PRO 95%^ 

The Ultimate Stand-Alone Help Authoring ^ 

Choice for Beginners and Professionals. 


Meet Het|> Magieian 

Since 1992 Help Magician has helped 
tens of thousands of companies create 
online documentation without requiring a 
separate word processor. With its 
WYSIWYG WinHelp simulated editor, 
you'll feel like you're working inside 
WinHelp. You can even test your help 
file as you are developing it without 
compiling. 

New Interactive Help Wizard f ^ 

We'd like to introduce a brand new 
technology so unique to help authoring: 
an Interactive Help Wizard 151 . If you 
don't understand how to do something, 
let the Wizard show you how! It can even 
act as your interactive tutor to teach you 
how to make a professional-quality help 
file. 


Help Magician Fra 95 Highlights 

* Create Help files for Windows and Internet 
Web pages from one source file. 

* Supports all new WinHelp 95 features such 
as authorable buttons, contents tab, etc. 

* Converts manual to help and vice versa 

* True WinHelp Project Management for 
workgroup authoring on a network 

* Integrated multimedia support 

* Built-in screen capture utility 

* Supports many graphic file formats 

* Extensive reporting 

* Lots of navigational aids 

* Visually design and position help windows 

* Fool-proof macro editor 

* Works alone or with any programming 
language for Windows 

* Makes help file shell from VB applications 

* Free drag-and-drop CNT file editor with new 
purchase of Help Magician Pro 95 

* Includes all help compilers 

* 30-day money-back guarantee 

* Free technical support 

* Free working demo 

* Corporate and Site licensing available 


•>m fii..-i«jf T«e1 t»I»liti 

-.. ~. Lei - : «JI*~ ~ 
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JR 

Actual WYSIWYG editing environment shown here with 
simluated Contents Tab and Interactive Help Wizard. 



Software Interphase Inc. 

ESTABLISHED 198 


Order today! 

1 - 800 - 542-2742 


82 Cucumber Hill Rd 
Foster, Rl 02825 
Tech: 401-397-2340 
Fax: 401-397-6814 
email: 

slnterphas@aol.com 


http://www.sinterphase.com 

Your WinHelp Resource for Books & Software! 
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Visual Basic Tool Showcase 



Vantage Control Set 


Breaking the barriers with a unique and affordable library 


of custom VBX and OCX controls 




□ 

H 



E3 

brfl 


Pub ID 

Name 

City 

Telephone 

1 

ACM 

New York 

212-869-7440 

2 

Addison-Wesley 

Readinq 

617-944-3700 

3 

Bantam Books 

New York 

800 223-6834 ffc 

4 

B en jamin/Cumminqs 

Redwood City 

800-950-2665 

5 

Biady Pub. 

New York 

212-373-8093 

6 

Computet Science Press 

New York 

212-576-9400 

7 

ETN Corporation 

Mont ours ville 

717-435-2202 

8 

Gale 

Detroit 

313-961-2242 

9 

IEEE 

Los Alamitos 

800-272-6657 


Tired of working around the limitations found in the standard controls of Visual Basic u ? Have 


you wanted to do immediate data validation for each of your controls, but the way VB handles 


focus events keeps getting in your way? Have you wanted to add drag-and-drop operations to 


your programs, but the current methods seemed too cumbersome? Then get the Ad-Vantage, 


add Vantage Control Set to your toolbox today. 


• Includes enhanced data-aware TextBox, Static/Label, 
ListBox, and ComboBox controls. 

• VFocus control that allows data validation through 
intelligent management of VB Focus events. 

• VForm control for 3D form display effects and 
custom drag-and-drop operations. 


Ask for information on Vantage Power Strings and Vantage 
Application Factory. For a limited time purchase both Vantage 
Control Set and Vantage Power Strings for only $99.00. 



Only $69.00 


VantagePoint Software, Inc. 


1619 E. Lakeview Drive 


Bountiful, UT 84010-1561 

Phone: 801.292.5344 Fax: 801.292.3142 

http://www.vpsoft.com/~vantage/ 


* prices may vary outside of North America. 

Vantage Control Set is a trademark of VantagePoint Software, Inc. Visual Basic is a registered trademark of Microsoft. 
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Visual Basic Tool Showcase 


Only Segue QualityWorks can test your 
client/server applications from head to toe. 



Middleware 


Why? Other test tools stop far short of complete distributed 
client/server testing — which is much more than just load 
testing a client/server application. You must also test all 
the application components — not only the GUI, but the 
servers, databases, networks, clients and middleware that 
make up the system — to gauge how everything will work 
in production, when running on multiple platforms and 
communicating across a network with a variety of 
other applications. 

QualityWorks is the only testing system on the 
market today that can completely test all components 
J of your client/server applications, while addressing the 

r six key problems of client/server application testing: 

► Validating all application components such as GUI, 
database, middleware and performance 
► Keeping pace with change to application components 
such as GUI, hardware, and application logic 

Automating test creation and maintaining multi- 
platform tests 

► Creating distributed network tests that today 
require intensive manual effort 
► Achieving immediate results with existing staff 
► Integrating the testing effort with complementary 
testing technologies. 


Discover the endless possibilities of QualityWorks 
automated client/server testing. 

Ask for a copy of our FREE White Paper — Complete QA: 
Testing All Components of Your Client/Server Applications. 
Check out our web site from 
head to toe and we’ll even 
send you a full-color poster 
of our little friend here. 

Just click on QA4U. 


Segue 

O SOFTWARE 

http://www.segue.com 


Call 800 - 287 ” 1329 today... 


FtSS 


Server 


Database 


Client 


Network 


Client 

Logic 


workgroup Server 


When it comes to Segue QualityWorks™ 

automated software 
testing, there’s only one 
way to go: QualityWorks 
from Segue Software. 

QualityWorks makes 
even the most complex 
testing simple. It leverages 
the power of Segue’s 
unique QA Partner 
cross-platform testing 
technology and open 
QA architecture to validate all components of second- 
generation distributed client/server applications. No other 
test tool even comes close. 


\ Partner Distributed ► QA DBTester™ 

► Agents 

a i 


Distributed 


resting 


QA Partner 0 


Test 

Management 


► QA Planner" 


QA Partner is a registered trademark of Segue Software, Inc. 1320 Centre Street, Newton Centre, MA 02159 Email: info@segue.com. 
All other system and product names are either trademarks or registered trademarks of their respective companies. 
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Visual Basic Tool Showcase 


Boost your Basic! 

Develop your Basic app faster: Get 
TeraTech tools! 36 Visual Basic, Quick 
Basic, Power Basic, C, Delphi and Xbase 
libraries available. Call, E-mail or fax us and 
we'll mail you a free demo disk & booklet 
ASAP. Or for faster service download by 
FTP or from our BBS. Call now! 

* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree ind ex..$149 

* ProMath/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* QuickLine/VB - telephony (multi-line) ...$495 

* SpellCheck/VB - spelling & lookup. $49 

* QB/C/dBase -15 more DOS libraries ...$call 

* VB training - 2 day intro super class ....$599 

* Cus tom - C , VB, ASM pro gramming .. ..$80/h 

800-447-9120ext. 1158 

Dept 1158,100 Park Avenue, Suite 360, Rockville MD 20850 USA 
Int i: +1-301-424-3903 Fax:(301)762-8185 BBS: (301)762-8184 
info@teratech.com ftp.teratech.com/pub/teratech 
http://www.teratech.com/teratech 


No 
60 Day O 
Trial! Jj - 
FREE demo 
& booklet! 
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Picasso 


Create Windows interfaces for legacy applications in minutes, not 

months! 

Picasso enables the program¬ 
mer to capture legacy screens 
and map new controls to legacy 
functions. Picasso generates 
ready-to-run Visual Basic front 
ends for IBM 3270/5250, 

Siemens 9750 and DOS appli¬ 
cations. No modification of 
legacy source code is required. 
Picasso is wrapper technology at 
its best! 

WINGate Technologies • P.O. Box 327 INTRA-SYS • Oldenburger Allee 12 • 30659 

298 Hope-Bridgeville Road • Hope NJ • 07844 Hannover • Germany • Tel 0511.61389.15 

Tel 800.946.4283 & 908.459.9293 • Fax 908.459.4001 Fax 0511.61389.99 • picasso@intra-sys.de. 

wingate@wingate.com • http://www.wingate.com 
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iSmSrZyi McCabe 
■■ wk kZH Associates® 

Uncover Your Software 

For Further Information Call 800-638-6316 or Fax 410-995-1528 
5501 Twin Knolls Rd. • Suite 111 • Columbia • MD • 21045 
http://www.mccabe.com 


□ Request Reader Service #126 □ 














































Visual Basic Tool Showcase 


NetWare Interface for VB 

Save hours of development time writing 
NetWare-Aware Windows 95, 3.1 and NT client 
applications using The NetWare Interface for 
Visual Basic SDK. This developer kit contains all 
of the latest DLL’s, function declares, 
structure/constant definitions, sample code, and 
the “VB Programmer’s Guide to NetWare”. 
Supports NetWare 3x, 4x (Directory Services). 



Ztech Software — Austin, Texas 
TELE: (512) 495-9101 
FAX: (512) 495-1803 


tj Request Reader Service #127 □ 


Visit 


Windows 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


http ://www. wdj. com 


See What an NT Server 
Can Really do! 


RPC for NT shows you how to write a distributed application 
using the Remote Procedure Call model, a powerful technology 
that allows server and clients to share not just data files but 
CPU cycles. 

Using Microsoft's RPC implementation, an NT server and 
clients running MS-DOS, Windows 3.1, Windows for 
Workgroups, or Windows NT can work together to solve a 
complex problem in a fraction of the time it would have taken a 
single machine. 



Build Remote Procedure Calls 
from basic to Sophisticated 

Guy Eddon guides you from a simple "Hello 
World' 1 RPC application through a series of 
increasingly demanding programs that 
encompass all aspects of remote procedure 
calls. You’ll learn about: 

■ Implicit and explicit binding procedures 

■ Structured exception handling 

■ Multithreaded sen/ers 

■ The RPC name service 


Order your copy today! 

Use code T58C when ordering 
RPC for NT with disk included 


$ 39 - 

plus shipping 


OH 

DISK 

INCLUDED 


R?D 

Technical 

Books 


913-841-1631 
FAX 913-841-2624 


|VISA |l^^>| 
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Visual Basic*: Debug, Optimize & Analyze It All 

with Marquis VB/FailSafe r 

. N e * Version! 4 
Visual Basic 3 #, a , 

• W°ndn Filename 

’JSSSff 


Marquis VB/FailSafe Takes You 
Above and Beyond Visual 
Basic’s Debugger! 

VB/FailSafe Highlights Bugs! Watch OLE 
servers & program flow. Spot event 
driven bugs & uncontrolled recursion. 
Monitor memory & resource usage. Catch 
parameter errors, symbol table exhaustion, 
control problems, OCXA/BX/DLL version 
conflicts, WinAPI errors & lots more! 

VB/FailSafe Crash-Proofs your Programs 

by automatically intercepting and coding 
errors by class, project, module, procedure 
and line number. Writes log files for later 
debugging and QA. Shows calls leading to 
the error, over 75 data points to help you 
spot platform problems fast! 

VB/FailSafe Analyzes & Profiles 

procedures with microsecond resolution. 
Profile resources, memory, hits, time, 
utilization. Graphically displays information. 
Highlights performance bottlenecks! Spots 
memory hogs! Much more! 

Money Back Guarantee! • Free Demo 
P.O. Box 387, Pomfret Center, CT 06259 
(860) 963-7065 fax (860) 928-7727 


“Marquis has assembled some dynamite tools 
and utilities. They go above and beyond 
Visual Basic’s debugging capabilities... 

for smooth operation. ” 
—VB Tech Journal, Feb. ’96 









VB/FailSafe 

Visual Basic 

VB/FailSafe vs. Visual Basic 



Get VB/FailSafe, Call Now (800) 818-1611 

VB/FailSafe for Visual Basic...still only $179.95 
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Visual Basic Tool Showcase 


Visual Internet Toolkit 


Save months of TCP/IP programming! 


Fill in properties 






Object |coemand1 Pioc: [cicii 

Private Sub Conm>andl_Clic»c() ~ 

• Connect to the FTP Server 


FTPClient.Action * ACTICWCONNECT 
' Transfer Remote File to your machine 
FTPClient.TileAction - FILE_ACTICH_GET 



OLE Custom Controls 

Just ask any OCX jockey. With Distinct’s Visual Internet 
Toolkit, adding TCP/IP connectivity to your application 
is not much farther than a drag-and-drop away. 
Whether you need a customized FTP client or most 
any other Internet application, you can simply embed 
an OCX into your program and Visual Internet 
will do the rest. It’s that easy. And you’ll have 
great looking, powerful applications. 


Protocols 

• Windows Sockets 

• Telnet 

• TCP/UDP/ICMP 

• VT 220 

• PPP/SLIP/CSLIP 

• WinSNMP 

• E-mail/SMTP 

• ONC RPC/XDR 

• POP 2/POP 3 

• rep 

• News/NNTP 

• rexec 

• FTP 

• rlogin 

• TFTP 

• rsh 

• TCP Server 

• And many more 

Interfaces* 

Environments 

•32 bit (95 and NT) 

• Visual Basic 

• 16 bit (Windows 3.x) 

• Visual C/C++ 

• C++ Class libraries 

• Delphi 

• DLL’s 

• C/C++ 

• OCX's 

• Access 

• VBX's 

• FoxPro 


32 Bit Performance 

The power of our new 32 bit Visual Internet Toolkit 
is simply unsurpassed. More custom controls. More 
protocols. More sample code. More Documentation. 
Which makes your job easier and leaves the 
competition in the dust. 


{ 


Call now for 
30 minute / 
Internet 
Delivery! ^ 



FI 


Jk > . 

distinct 


The world leader in Internet development tools. 


u 408.366.8933 

World Wide Web: http://www.distinct.com 
Fax: 408.366.0153 

E-mail: windev@distinct.com 

Fastfacts: 408.366.2101 


•Not ill interfaces may be available (or all protocols. Ucmsrng fee required lot redianbuoon. Distinct is a registered irakmari; and 30 minute Internet Ddiveryl and Visual Internet is a tfademark of the Distinct Corpomioii. Cop>Tigjit 1995 Oistina Coqx>nboo. 12900 Sanioga .h«nue. Saratoga. CA 95070. All rights reserved. Specifications and delivery terms are subject to dange wilhout notice. 
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Visual Basic Tool Showcase 




Featuring more than 35 chart types, Chart FX plays 
the role of four different models [VBX, OCX, DLL 
and VCL] who got to the top of popularity among 
Windows Developers. This award-winning charting 
component displayed amazing skills in this film. 
Infoworld says "Chart FX 3.0 has been reviewed and 
proved to be technologically superior to competing 
products. Because of that is has been chosen as a 
Hot Pick as well as receiving the highest score of all 
reviewed products." 

Offering RealTime charts, End user Tools, double y 
axis, Log Scale, Surface Plots, Polar Charts and 
unlimited support for all types of business and 
scientific charts, Chart FX is a tough contender for 
an academy nomination. ___ 

This action thriller also features Chart FX 3.0 pi® 
32-Bit models working under Windows 95 and jg 
Windows NT. Their speed and smooth integra- | Mi 
tion with all popular development tools is ■ H 
just unbelievable! 


In its first career appearance, Report FX shines in this 
magnificent role. Its mainstream-worlwide audience 
found it, followed it and Report FX is now the premiere 
choice in the reporting tools arena. 

Part of the attraction of this film is the chemistry 
between its two principals -Chart FX & Report FX- 
which create a technological breakthrough ahead 
of its time. Plus a unique approach to create reports 
which includes a tool to create visual ER diagrams, 
ODBC and BDE connectivity, and 
the only report designer so easy 
that even the least technical 
people can use it. 

You'll be surprised of ^ 

_ how flexible and power-^^-^A G ^,ft^\ 
pnj ful this reporting tool is! 
i We' 11 guarantee you'll 

V lore "■ 

ini! Call now and get a special 
bundle price. 
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It's a snap to compile your 
Visual Basic code into FAST, 
industry-standard DLL's. Just save 
computational code to .BAS files - 
compile to a DLL - you'll boost 
performance 5 times. 10 times, or 
even more. No need to struggle with 
C++ or Delphi. Compile true machine 
code DLL's from your Basic code! 

Use Visual Basic for what it 
does best - user interface and 
forms design. Use PowerBASIC for 
what it does best - number crunching, 
calculations - all of your mission-critical 
code! Link this duo for the ultimate 
programming team! 

PB/DLL is a native-code Basic compiler offering 
advanced features like code pointers, data pointers, 
even a built-in assembler. It creates industry 
standard DLL's using the full power of the 32-bit 
instruction set. PowerBASIC DLL's are accessible 
from any 16-bit or 32-bit Windows application. 

PowerBASIC DLL Compiler... 
the perfect complement to Visual Basic 


“You don’t have to wait for Microsoft, 
or learn another language to get better 
performance out of your Visual Basic apps 
- just identify the bottleneck in your code an d| 
compile the slow procedures as a DLL. 

IT’S A SNAP!” 

-J.D. Hildebrand, Editor VB Tech Jouui 
December, 


Buy PB/OLL Compiler 

4149. 11 

and you’ll get 


PowerBASIC 


316 Mid Valloy Center • Carmel, CA 93923 
Order Desk: (800) 780-7707 

Voice: (408) 659-8000 

FAX: (408) 659-8008 

BBS: (408) 659-7401 

CompuServe: Go PowerBASIC-Section 12 
lnfoWPowerBasic.com 
http://www.powerbaslc.com 


YES! I want PB/DLL Compiler for $149 

□ No. please send me more information first. 


□ Payment enclosed Charge my □ VISA □ MC □ AmEx 3 0. 



Protection Plus Professional 

Advanced Security Toolkit for Total Application Control 


Have you ever wondered how many 
illegal copies of your application that 
you spent your time, effort and dollars 
developing are floating around? How 
many additional computers are 
running your application from one 
copy? The (PPP) system answers these 
questions for you. Zerol The PPP system 
insures proprietary copy protection 
and control in single use and network 
client/server applications. Remote 
unlock capabilities give you complete 
control. The PPP system consists of two 
parts. Part 1 is the set of library functions, 
added at development time, that 
enable copy protection and 
application control. Part 2 is o Client 
Tracking System that stores protection, 
version and historical information 
about each client and distributor. 


Features include: 

B Remotely unlock and extend fully or 
partially functional demo teasers. 

H Ensure lease payments by 
including periodic disabling logic. 

9 Create a distribution channel for 
your application by converting 
illegal copies into demos, 
a Full network copy protection 
including server drive or 
workstation-specific. 

B Serialize and customize .EXE files 
without recompiling, 
a Remote unlock capabilities reduce 
overhead and shipping costs. 

B Copy protect your applications by 
authorizing a particular computer 
or hard drive. 


Fully Customizable! 
No Runtime Licenses! 


-0 


ONCEPT 


SOFTWARE 


HTum illegal copies into cash. 
H Protect your investments. 
Win16 or Win32 PLL $169 

Win16/32 PLL Bundle $209 

216-943-4341 461 E. 327th Street 

&00-6& 5-7638> Cleveland, OH 44095 
Fax: 216-943-4346 

World Wide Web: http://www.consoft.com 
Internet: ppp_info@mailer.consoft.com 


□ Request Reader Service #131 □ 


(continued from page 20) 

Place the code in Figure 2 in the click event of the com¬ 
mand button and run the program. Since the code simply cre¬ 
ates a brush using the backcolor of the form and fills a rectan¬ 
gle using that brush, you would expect the rectangle to be 
transparent. In this case, unless you have a dark system but¬ 
ton color, you see a marked difference between the form color 
and rectangle color. Figure 3 shows the result, which is a rec¬ 
tangle that is black, rather than the color of the button face. 

What actually happens is that the form you create defaults 
to a 3D appearance, which forces the backcolor to 
vbButtonFace (&H8000000F&). The high byte of RGB color val¬ 
ues is normally 0, leaving a valid range of &H0 to &HFFFFFF&. 
The remaining three bytes, from least to most significant, 
determine the amount of red, green, and blue, respectively. 
When a color value has a high byte that is not 0, Visual Basic 
treats the value as a system color, generating an error if the 
value is outside the valid range for system colors. 

While VB knows how to interpret the constants, API calls 
like CreateSol idBrush( ) do not. They assume the value is an 
RGB value and use it directly. With &H8000000 F&, 
CreateSol idBrushC ) ignores the high byte, which is out of 
range, and creates a brush with the color &HF&. 


Choose a new backcolor in the property window for the 
form and rerun the code. The rectangle is transparent since 
the backcolor property now contains a true RGB value. When 
you set the color back to any valid system color constant, the 
problem reappears. 

The use of system color constants will also affect DLLs and 
routines you write that expect or act on RGB values. The solu¬ 
tion is to write a translation function that recognizes the con¬ 
stants and returns the true RGB value. 

Constant to Color Translation 

Insert a new module into your project and add the declara¬ 
tions and RealColorO function from Figure 4. RealColorO 
uses the Windows function GetSysColor () and some known 
characteristics of the VB system color constants to perform 
the translation. 

RealColorO accepts one argument, which it compares to 
the range of Visual Basic system color constants (&H80000000& 
to &H80000018&). If the value is outside that range, the function 
assumes a valid RGB color value and returns it unmodified. 
This behavior allows you to send any color value to the func¬ 
tion without worrying about whether it is a constant or RGB 
value. 
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Figure 1 Declarations for needed Windows API functions 


#If Win32 Then 

Declare Function FillRect Lib "user32" _ 

(ByVal hDC As Long, IpRect As RECT, 

ByVal hBrush As Long) As Long 

Declare Function CreateSolidBrush Lib "gdi32” 

(ByVal crColor As Long) As Long 

Declare Function DeleteObject Lib "gdi32" _ 

(ByVal hObject As Long) As Long 

Declare Function GetClientRect Lib "user32" _ 

(ByVal hWnd As Long, IpRect As RECT) As Long 
Declare Function Inf1ateRect Lib "u$er32" _ 

(IpRect As RECT. ByVal X As Long. ByVal Y As Long) As Long 

Type RECT 

left As Long 
top As Long 
right As Long 
bottom As Long 
End Type 


#E1self Win16 Then 

Declare Function FillRect Lib "user" _ 

(ByVal hDC As Integer, IpRect As RECT, _ 

ByVal hBrush As Integer) As Integer 
Declare Function CreateSolidBrush Lib "GDI” _ 

(ByVal crColor As Long) As Integer 
Declare Function DeleteObject Lib "GDI" _ 

(ByVal hObject As Integer) As Integer 
Declare Sub GetClientRect Lib "user" 

(ByVal hWnd As Integer, IpRect As RECT) 

Declare Sub Inf1ateRect Lib "user" _ 

(IpRect As RECT, ByVal X As Integer, ByVal Y As Integer) 

Type RECT 

left As Integer 
top As Integer 
right As Integer 
bottom As Integer 

End Type 

#End If 


GetSysColor() accepts an index that specifies a Windows 
display object and returns the RGB color value of that object. 
When Real Col or () detects a system color constant, it strips off 
the last byte, which conveniently maps directly to the index 
argument required for GetSysCol or(). 

To test the solution modify the following line in the com¬ 
mand button's click event: 

hBrush=CreateSolidBrush( (Me.BackColor)) 


to read: 

hBrush=CreateSolidBrush( RealColor(Me.BackColor)) 

Run the program to verify that the rectangle on the form now 
fills with the correct color, regardless of whether the form's 
backcolor is set to a system color constant or to a true RGB 
color value. 
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Windows Developer’s Journal buys dozens of articles each year 
from readers like you. You don’t have to be a writer, but you do 
have to have a concrete topic of interest to other Windows pro¬ 
grammers. Most of the articles we use are built around short 
(100-300 lines), reusable code that solves specific problems of 
interest to Windows programmers. We are especially interest¬ 
ed in Visual Basic article proposals at this time. The easiest 
way to propose an article topic is to send email about your idea 


Call for Papers 

to the editor, Ron Burk, via CompuServe at 70302,2566 or 
Internet at 70302.2566@compuserve.com. Make sure you 
include an estimate of the number of lines of code involved. 

If you don't have access to email, you can fax your proposal to: 
Managing Editor, Windows Developer’s Journal, (913) 841-2624, or 
mail it to: Managing Editor, Windows Developer’s Journal, 1601 
West 23rd St., Suite 200, Lawrence, KS 66046-2700. 

(913) 841-1631; FAX (913) 841-2624. 


Visual Programming 

■ Proposals due 15 Apr 1996 
manuscripts due 15 May 1996 

Suggested topics: Enhancing the 
VB4 listview control. A reusable func¬ 
tion for adding your app to the system 
“tray.” A Delphi treeview control with 
automatic structured storage backup. 


Database Programming 

■ Proposals due 15 May 1996 
manuscripts due 14 June 1996 

Suggested topics: Five tips for 
faster ODBC queries. A C++ class 
that simplifies ODBC access. A top 
ten list of SQL tricks that save time 


Communications/Networks 

■ Proposals due 14 June 1996 
manuscripts due 15 July 1996 

Suggested topics: A simple, reusable 
function for sending text via MAPI. A 
benchmark comparison of common 
client/server communication mecha¬ 
nisms (named pipes, RPC, etc.). Ten 
tips and tricks for RPC programming. A 
configurable function for performing 
automatic product registration via FAX. 
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CreateFile Quicklnfo Overview Group 

The CreateFile function creates, opens, or truncates a file, pipe, 

Current annotation: 


The documentation claims CreateFileO returns a handle 
that can be used to access the object. However, under 
both NT and Win95, CreateFileO will appear to succeed 
and return a valid handle il you attempt to open a file with 
GENERIC_WRITE permissions on a read-only medium 
(e.g., protected floppy or CD-ROM). If you then try to 
perform a write with the returned handle, that will fall. 
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GetWindowText Quicklnfo Overview Group 


The GetWind owText function copies the text of the SDecified 

Current annotation: 


3 


The third argument is the “maximum numbers of 
characters to copy”. It may not be clear that this number 
must include the NULL byte so, for example, it never 
makes sense to set this argument to 1 since all you could 
get back is a NULL byte. If you want to use 
GetWindowText0 to retrieve a single character (e.g., from 
an edit control), you would have to specify a length of 2 - 
one for the character and one for the terminating NULL 
byte. 

Submitted by: Tony Yuricich 
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Whether you're 

HEADED TO CHICAGO, 

Daytona, or 

POINTS UNKNOWN, 
BASICSCRIPT HELPS 



it easy and economical to add an 
award-winning scripting language 
to your application. 


B Easy-to-use APIs make it simple to 
integrate BasicScript into your 
application using C, C++. Visual 
Basic, or other tools. 

B Compatible with the syntax of 
Microsoft Visual Basic and Visual 
Basic for Applications (VBA). 

B Controls OLE Automation objects in 
Windows, Windows NT, Windows 95. 
and Macintosh applications. 

a Extensibility p — — — —- q 

architecture | CALL TODAY FOR 1 

S' 0 ”'" | your FREE I 
lEvauuuoNCORfrf 
keywords to I 315 445.9000 ■ 

BasicScript. I--I 

a Available for Windows 3.1, Windows 
95 (“Chicago"), Windows NT 3.5 
(“Daytona"), MS-DOS, SunOS, Solaris 
2.x, HP-UX, IRIX, .MX, SCO UNIX, 

Ultrix, Digital UNIX. UnixWare, 
Macintosh. Power Macintosh, 

NetWare, OS/2, and OpenVMS. 
a Runtime can be redistributed by your 
customer without royalties, 
a Free technical support, 
comprehensive documentation, and 
numerous code samples keep your 
engineering costs to a minimum, 
a Licensed by Symantec, Delrina, Intel, 
and other leading companies. Named 
PC Magazine Editors' Choice among 
cross-application macro languages, 
a Flexible licensing terms mean you can 
afford the finest scripting language on 
the market today. 

O B/&icScript 

Summit Software Company 

Fax: 315 445.9567 
CompuServe: 71211.3504 
Internet: info@summsoft.com 
WWW: http://www.summsoft.coin 
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Figure 2 Passing VB system colors to 
Windows 


Private Sub Coinmandl_Click() 

#If Win32 Then 

Dim hBrush As Long 
#E1self Winl6 Then 

Dim hBrush As Integer 
#End If 

Dim RECTrc As RECT 
Dim retcode As Long 

'Create a rectangle 20 pixels smaller than the form 
GetClientRect (Me.hWnd), RECTrc 
InflateRect RECTrc, -20, -20 

'Create a solid brush using the backcolor of the form 
hBrush - CreateSolidBrush((Me.BackCoTor)) 

'Make sure we got a brush before calling API 
If hBrush Then 

'Fill the rectangle with the created brush 
retcode - Fill Recti(Me.hDC), RECTrc, hBrush) 

'Free up the brush 

retcode - DeleteObjectChBrush) 

End If 

End Sub 


Summary 

When assigning values to color properties in Visual Basic, 
you should use defined system color constants to present a 
consistent interface to the user. If you need to pass colors to a 
DLL or the Windows API, or to manipulate RGB values in 
your code, do not assume that form or control color proper¬ 
ties contain valid RGB color values. In those cases, use 
Real Col or () to ensure you are working with the correct 
value. □ 
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Figure 3 VB system color gets mapped to 
black 


Introducing Mr. Phelps 



One object-oriented module, shipped with full ’G' source, 

providing C/C++ programmers with the functions of 
Copy Protection, Installation and Trial-Basis Disabling. 



♦ Enforce trial-distribution and 
shareware expiration dates by 
number of days, absolute date 
or number of runs. 

♦ The ultimate in a customizable 
installer, you have the source ! 


♦ Copy Protect executables 
based on system ID, logical 
and physical position. 

♦ Prevent diskcopy of 
distribution media. Detect 
duplication when it occurs. 



Dos and Windows Only $99 

Soflware Systems 
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these hardware interfaces with no modifications to your application. 
WIBU-KEY doesn’t just do a quick check to see if | 
the dongle is there - it works by encrypting the 
executable through our custom ASIC. With top 
notch security and flexibility, along with other great 
features like remote programming, secure limit 
counters, and automatic or API-based encryption, you’ll quickly see 
why WIBU-KEY is the best software copy protection available. 


We are 
looking for 
international 
distributors 
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SYSTEMS 
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Figure 4 Translating VB system 
colors to RGB 


'General Declarations 
#If Win32 Then 

Declare Function GetSysColor Lib ”user32" _ 
(ByVal nlndex As Long) As Long 
#E1self Win16 Then 

Declare Function GetSysColor Lib "user” _ 

(ByVal nlndex As Integer) As Long 
#End If 

Function Real Col or(ByVal TestColor As Long) As Long 

#If Win32 Then 

Dim syslndex As Long 
#E1self Win16 Then 

Dim syslndex As Integer 
#End If 

'Test for VB system color constant 
If (TestColor >- &H80000000) And _ 

(TestColor <- &H80000018) Then 
'get last byte to use as index to GetSysColor 
syslndex = TestColor And &HFF 
'Call API to translate 
Real Col or - GetSysColortsysIndex) 

Else 

'TestColor is not a system color constant 
'assume valid RGB value passed in 
RealColor - TestColor 
End If 

End Function 
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We believe building the installation should 
never be harder than writing the application. 




Eschalon Development is proud to present 
Eschalon Setup Pro - A new addition to our 
installer family. Following in the success¬ 
ful foot-steps of EDI Install Pro, Eschalon 
Setup Pro brings you the features that 
power users crave, with the ease of use that 
the rest of us want. 

Put our expert to 
work for you! 

Don't get stuck in 
the dark ages 
with our compe¬ 
tition's shields and wizards, put our Setup 
Expert to work and charge into the 21st 
century! With the Setup Expert, building a 
complete installation is as simple as fol¬ 
lowing four easy steps - and that includes 
clicking on "Build Setup"! Within minutes 
your files are compressed and your disks 
automatically created. One click does it all! 

A standard, professional interface. 

The first thing your customer sees, is the 
installer. Eschalon 
Setup Pro's standard, 
professional inter¬ 
face makes them feel 
right at home. We 
don't clutter our 
windows with use¬ 




less gadgets or hokey graphics. A clean, 
standard interface, 
makes for a better 
product and leaves a 
lasting impression. 

Absolutely no hidden costs! 

Unlike some of our competitors, we don't 
charge royalties, and we don't require that 
you purchase a license for each product 
you distribute. Ask our competitors about 
their licenses - you’ll be surprised! 

You'll be in good company. 

Unlike some newer products, our installers 
have been used for years by the worlds 
leading organizations. Companies like 
AT&T, Bell Canada, BP Oil, Cirrus Logic, 
DOW Chemical, 

Eastman Kodak, 

Electronic Arts, 


a; 


Fannie Mae, Macromedia, Pacific Bell, Po¬ 
laroid Corp., Sprint, SunSelect, Xerox, Ziff- 
Davis Publishing, and the US Army Corps 
of Engineers. Why take chances? 

Some Eschalon Setup Pro Features: 

Standard, professional interface; 3D op¬ 
tional ♦ Dithered, tiled or bitmap back¬ 
ground ♦ Billboards ♦ Progress dialog ♦ 
Selectable components for custom setups ♦ 


Automatic file 



No programming required 
compression ♦ Ver- 
sion resource check- 0 * 
ing ♦ Disk branding 
with user name ♦ 

Auto font install ♦ Create & modify .INI 
files ♦ Create Program Manager groups & 
icons » Built-in readme viewer ♦ Small 
size ♦ Support for floppy, hard disk, CD- 
ROM, Network, and e-mail distribution ♦ 
Ask about our OEM version! 

ORDER NOW FOR ONLY $149.95! 

See our evaluation version on our BBS, or on 
CompuServe's "WINSDK" forum, file "ESETUP.EXE'. 
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Books in Brief 

First Impressions of Recent Titles 


Delphi Programming Unleashed 
Charles Calvert 
930 pages 

Sams Publishing, 1995 
$45.00, includes CD 
ISBN 0-672-30499-6 



Unleash the 
Power of 
Delphi! Q 



UNLEASHED 


[Editor's note: this review was provided by George Tylutki.] In 
the Introduction Calvert writes, "If you want a reference to the 
components used in the environment, just pop up the online 
help. If you want to find out how to create programs, turn to 
this book." Delphi components are easy to use and Delphi 
does facilitate Windows programming, but non-trivial pro¬ 
grams require writing code, which is the book's focus 
(although most of the components are covered incidentally). 

This is a big book that covers a lot of material: 300 pages on 
basic Object Pascal; 150 on arrays, records, strings, files, point¬ 
ers, pchars, and linked lists; 150 on database tables, aliases, 
data-aware components, SQL, the TQuery object, fields and 
the fields editor, and the Local Interbase Server; and 90 on 
messages, objects, inheritance, encapsulation, properties and 
polymorphism. The database material is quite good, but 
Calvert doesn't say much about ReportSmith and barely men¬ 
tions version control. There are only 30 pages on creating com¬ 
ponents, 25 pages on DDE and OLE, and 15 pages on DLLs. 
The 17-page treatment of exceptions is especially weak. 
Further, he devotes too much space to less-than-crucial topics, 
such as DCC (Delphi's command-line compiler) and Borland 
Pascal's Object Windows Library (OWL). Turbo/Borland Pascal 
programmers will find only about half of the book useful. 


Ron Burk 

Calvert progresses from the basics to advanced techniques. 
In general, his explanations are neither weak nor strong and 
some sections are better than others. Toward the end of the 
book the explanations become shorter (the more you have 
learned, the less has to be explained) and less repetitious. Still, 
this is not a reference work, and because it is so large and the 
index is only fair, it can be difficult to relocate material you 
have read. 

There are the usual number of typographical and writing 
errors and the book shows signs of the haste to get it into 
print: there is a reference to a nonexistent chapter and some of 
the internal cross-references are to wrong pages and chapters. 
However, Calvert gives his CIS, Internet, and AOL addresses 
and other addresses where corrections and updates to the text 
and code can be obtained. 

On p. 714 he writes, "You don't need to understand poly¬ 
morphism or much about objects to program in Delphi. 
However, if you want to be an expert Delphi programmer and 
want to create components, this is material you should mas¬ 
ter." He covers this and other topics (Intel architecture, memo¬ 
ry layout, binary representation of data, etc.) more than is 
strictly necessary, but it's probably better to complain that 
there is too much in a book rather than too little. If you know 
nothing about these subjects, his discussions will be informa¬ 
tive. 

Calvert is very sympathetic to the difficulties of making the 
transition from DOS to Windows, from C to Pascal or from lit¬ 
tle programming experience to immersion in Delphi, but his 
sympathy occasionally leads him to underestimate the read¬ 
er's capabilities, which can result in sympathetic condescen¬ 
sion. The various programs in the book are, for the most part, 
short, teaching programs. However, as the book progresses, 
useful functions and procedures for manipulating strings and 
numbers are added to two utility units. 


Got an opinion about these or other programming books? Send them to 70302.2566@compuserve.com. You can order any of the books 
that appear in Books in Brief from Miller Freeman, Inc. by calling (913) 841-1631, faxing (913) 841-2624, or sending email to 
rdorders@rdpub.com. If using fax or email, send the book title, author, and publisher along with your MasterCard or Visa number, expi¬ 
ration date, and phone number. 

To submit books for review, send them to: Ron Burk, 13846 NE 60th Way, #120, Redmond, WA 98052-4542. Please do not send press releases to 
this address. 
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The CD contains the code for all programs and for addi¬ 
tional programs that aren't included in the book. It has an 
install program and also contains Video for Windows (some 
projects in the book require it). There are demonstration ver¬ 
sions of several commercial products: Orpheus VCL, AccuSoft 
Image Manager, The Generator 2.5, ForeHelp Help Authoring 
System 2.0, PowerTCP Standard Toolkit 1.1, Chart FX 3.0, 
ProEssentials 1.5, and Media Developer OLE Controls 2.0. 

Some of the programs on the CD are copyrighted and some 
are not. The copyright notice on the inside back cover says the 
software is licensed for use on single computer. In the get- 
start, wri file on the CD, the author explains that you can't 
use any of the code to create another educational book, tool, or 
article without his permission, and that teachers cannot use 
the code in class unless they are using his book. And finally, he 
says you can use the code, for example, to write a financial 
program for a bank but not a book on Delphi programming. 
This seems reasonable. 

At one point (p. 714) Calvert says (regarding polymor¬ 
phism): "I'm going to cover this material several times in sev¬ 
eral different ways, and by the time you are through, you're 
going to get it." This is his method throughout the book. It is 
pedagogically correct: he states the objectives of the book, 
chapters, and sections and summarizes what has been cov¬ 
ered for every chapter (and most sections). He rephrases and 
restates the material frequently and supports abstractions 
with concrete examples. 

But this is a boring book. It's not the material but the 
author's method (even the advanced topics are boring). 
Further, he breaks up the flow of the material with introduc¬ 
tions, summaries, asides, and explicit descriptions of what he 
is doing as he is doing it. For example, on p. 513 there is a sum¬ 
mary for a one-page section. On p. 867 he begins a section by 
stating what will be covered, then, less than 1/2 page later, he 
writes, "I will spend the next few paragraphs introducing...." 
Still, I prefer that the author be informative and thorough 
rather than chatty, pseudo-funny or cool. 

If you prefer a shorter, livelier book, with anecdotes and 
"humor," then the best alternative is Delphi Programming 
Explorer by Duntemann, Mischel, and Taylor, although it is not 
as comprehensive as Delphi Programming Unleashed, which is 
(1) long and (2) boring. Read a couple of pages in the book¬ 
store before buying it. You know what you like. I find it to be 
an excellent introductory text. 


Delphi: A Developer's Guide 

Bill Todd and Vince Kellen with Ray Novak 

and Brad Saenz 

820 pages 

M & T Books, 1995 

$44.95, includes CD 

ISBN 1-55851-455-4 



[Editor's note: this review was provided by George Tylutki.] This 
book might be titled Delphi: A Database Developer's Guide. Its 
focus is the development of database applications and it cov¬ 


ers the subject very well. It is not a general guide to develop¬ 
ing Windows applications using Delphi, and there are many 
topics it does not address, such as OLE, DDE, multimedia, 
and accessing the Windows API. 

The audience is intermediate and advanced programmers. 
Only two chapters contain novice-level material: Chapter 4, 
"The Delphi Development Environment" (30 pages: using the 
Speedbar, Component Palette, Debugger, Editor, etc.), and 
Chapter 14, "Anatomy of a Component" (20 pages: properties, 
events, sizing and aligning, etc.). 

The several chapters on Object Pascal and Object-Oriented 
Programming (about 200 pages) are good, but could include 
fewer screen shots and more information. Depending upon 
your experience, you may find them insufficient. Chapter 11, 
on reading and writing files using Pascal (text, typed, 
untyped, .ini files), is very good, and Chapter 20 is the best 
discussion of exception handling I've read in a Delphi book 
(which means it is good, not great). 

Sixteen of the thirty-three chapters focus on database pro¬ 
gramming. Both local and client/server database applications 
are covered. Because of the amount of material, I can only 
briefly list some of the topics. Chapter 2 contains a discussion 
of integrity (domain, column, etc.) and data normalization (1st 
normal form, 2nd normal form, etc.). Chapter 16 explores the 
Borland Database Engine (BDE) and data-aware controls and 
Chapter 17 covers connecting data-aware controls to local and 
server databases. Chapters 18 and 19 deal with the TQuery 
component and SQL. A sample database application (a pro¬ 
ject-tracking system) is built in Chapter 21. Making direct calls 
to the BDE via code is the subject of Chapter 22. Chapter 23, an 
overview of ReportSmith, shows how to create single-table 
and multi-table reports and how to run a report from inside an 
application. Chapter 24 focuses on managing transactions, 
including explicit/implicit transactions, SQL-92 and Delphi 
isolation levels, and locking mechanisms. In Chapter 25 the 
authors discuss local and client/server security (encryption, 
passwords, users, groups, privileges, etc.). Data integrity is the 
subject of Chapter 26 — domain and referential integrity, 
using triggers and views and more. Chapter 27 concentrates 
on Interbase and Chapter 28 on Microsoft SQL-Server. 
Chapter 29 suggests way to improve the performance of your 
database applications. Chapter 31, writing custom compo¬ 
nents, covers derived components, property editors, overrid¬ 
ing methods, and more; it is not comprehensive but does 
show how to create a new TTable type with an auto-incre¬ 
menting field. 

Unlike some writers, Todd and Kellen don't try to oversell 
Delphi. They point out some of its shortcomings (for example, 
Delphi lacks direct support for SQL ANY and ALL keywords) 
and demonstrate how to work around them. Some topics are 
covered in more depth than others and, by definition, some 
topics cannot be dealt with in detail (the variety of back-ends 
prohibits recommending a single security scheme or even giv¬ 
ing examples of each). They acknowledge Delphi's capabili¬ 
ties but repeatedly point out that you must know your server 
and database thoroughly. 

This is the only Delphi book I've read that includes a chap¬ 
ter on packing your application for distribution (Chapter 32). 
In addition to general recommendations about compressing 
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files and writing/purchasing installation programs, there is 
specific information about which files must be included (and 
licensing requirements) with various database applications. 
They even recommend including a known bug list in the 
package. Amen! In keeping with their aim of writing for pro¬ 
fessional developers they also discuss user-interface design, 
incremental development (let users test parts as they are com¬ 
pleted), and reusability (code, templates, components). 

The writing is clear and plain. There are no attempts at 
humor or being chummy and exclamation points are rare. 
However, the book needs another round of editing and proof¬ 
reading. There are too many typographical, punctuation, and 
grammatical errors. Some of the figures referred to in the text 
don't exist (Fig. 28.5) or don't illustrate what's stated in the 
text (2.11, 5.2, 18.16). Others don't match the code listings 
(10.1). Tables are incomplete (6.6) and code listings are misla¬ 
beled (8.3). 

Two other problems make the book more difficult to read 
than it should be. First, the text fails to consistently distinguish 
reserved words and variable, property, and method names by 
boldfacing or italicizing. Second, the use of commas appears 
to be random; they are inserted or omitted willy-nilly, which 
too frequently forces you to reread for comprehension. 

The index is only fair. There are no silly entries (although 
the names of every author of every book mentioned in the text 
are included). There just aren't enough, which is unfortunate 
because there is a lot of useful information in this book. 

Although CompuServe addresses for Novak and Saenz 
(not Todd and Kellen) are listed, no specific addresses or 
phone numbers are given by which readers can ask questions, 
submit comments or obtain updates or corrections. 

The CD includes all the code and (according to the back 
cover) "a set of third-party VCLs — custom controls you can 
use immediately in your own programs, royalty free!" This is 
misleading. The CD contains a program that demonstrates the 


capabilities of Woll2Woll Software's InfoPower, a set of data- 
aware components, not the components themselves. After you 
purchase them, you can use them without paying royalties. 
There is a full-page ad at the end of the book offering 
InfoPower for an introductory price, but the offer expired 
August 31,1995. 

There is no statement anywhere in the book or on the CD 
about using the code. Since none of the source code contains a 
copyright notice, I assume you can use any or all of it. 

There are better introductory Delphi books than Delphi: A 
Developer's Guide, and there are books which cover topics not 
included in this one (such as OLE and multimedia program¬ 
ming) or cover them better (writing custom components). 
However, this is the best book on using Delphi to construct 
database applications I've reviewed. 


Dynamics of Software Development 
fim McCarthy 
184 pages 

Microsoft Press, 1995 
$24.95 

ISBN 1-55615-823-8 



Last month, I reviewed Symantec executive Gene Wang's 
job handbook for programmers, and here is another unique 
entry from the software executive vanity press. The author of 
this book directs the "Microsoft Visual C++ Program 
Management Team at Microsoft" and gives well-received 
talks on the subject of software development, which he has 
turned into this book. There is no shortage of books that 
promise to reveal the one true way to manage the software 
development process, but this one has the added titillation of 
providing insider anecdotes about a product that many read¬ 
ers of this magazine use: Visual C++. 

The framework of the book is the exposition of 54 rules for 
"delivering great software on time" (Microsoft software is 
either "great" or "really cool," mantras repeated with the reg¬ 
ularity of a dripping faucet in every Microsoft product presen¬ 
tation), interspersed with stories and anecdotes. But these are 
not the usual kind of pithy management book rules, nor the 
usual kind of anecdotes. Instead, this book is greatly con¬ 
cerned with the psychological, with plenty of high-flown 
prose like this: 

If the leader can then resonate with the team's complex emo¬ 
tional state — identify with it, articulate it, and give the whole 
constellation of feeling and thought a visible, concrete reality in 
his or her own personal voice or gesture — the boundaries 
among the individual team members and between the team 
members and the leader will collapse. A wave of unity will 
wash over the entire community. Empathy will be established: 
the leader and the team will feel and know as one, giving voice 
and identity to what was an incoherent psychological commu¬ 
nity substrate. And it will feel good to the team to be under¬ 
stood and to understand. 
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However, there are also more down-to-earth passages, and 
anecdotes that are entirely readable and interesting. It is 
worthwhile to read an insider's view of the Microsoft devel¬ 
opment process, though you can safely ignore the author's 
implicit assumption that this is how all software should be 
developed. You can really get some insight into the oddities of 
Microsoft-think, such as when the author says "'zero defects' 
doesn't mean that there are no bugs in the software." There is 
a laudable emphasis here on the importance of people and 
relationships to the construction of software. The author right¬ 
ly points out that the product (software) is the stuff of pure 
intellect, so what could matter more than taking care of the 
brains that are producing it? The book pays more than lip ser¬ 
vice to the importance of empowering the people who actual¬ 
ly write the code. I doubt such writings 
turn any bad managers into good man¬ 
agers, but perhaps they can help inspire 
good managers to be better. 

Sometimes the book engages in deep 
psychological analyses while simultane¬ 
ously revealing deep pathologies. For 
example, apparently in all seriousness, 
the author studies the difficulties people 
seem to have in handling the empower¬ 
ment he is determined to thrust upon 
them at every turn: "Even in the most 
enlightened people you'll find a nearly 
irresistible impulse to endow people 
'higher' in the hierarchy than them¬ 
selves with the qualities of some sort of 
primitive power figure." How unen¬ 
lightened, those poor souls who cannot 
overlook the mere trappings of power — 
such as the ability to set their salary and 
stock options! Somehow, the process of 
getting to the top of the heap inflicts 
complete amnesia about what life was 
like at the bottom of the heap. I'm 
reminded of the time my Dad (a 
mechanic), bumped into his CEO (not a 
mechanic) who, just back from the coun¬ 
try club, regaled him with the recently 
discovered joys of the sport of tennis, 
and encouraged him to likewise partake 
of the experience. To which Dad replied 
"Great! Which afternoon this week 
should I take off to play tennis?" It turns 
out that folks who are higher in the hier¬ 
archy would really prefer that the rest of 
us not confront their delusions of homo¬ 
geneity quite so directly. 

The main fault I find with this book is 
that it aspires to be a book of general 
wisdom, but can't be because the world 
just isn't as uniform as it appears from 
within Microsoft (the author has experi¬ 
ence outside of Microsoft, but it's not ter¬ 
ribly broad experience). The author 
thinks "all software developers ... fear 


burnout." Some do, some don't (I sure don't). The author's 
view is that "any project that has more than seven milestones 
(or so) is suspect." Sounds like all really large software pro¬ 
jects are suspect. The author believes that "the only consensus 
worth having is a creative one achieved in the combat of fully 
engaged intellects." Sorry, there are teams that achieve worth¬ 
while consensus without Microsoft-style combat (it probably 
helps if your team is more balanced in age and gender than the 
typical Microsoft development group). The author states with¬ 
out qualification hard and fast rules such as "you're not going 
to get away with many more than two developers for every 
one QA person." Alas, there are more ways of successfully 
developing software than are dreamt of in his philosophy. 
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#include <iostream.h> 

extern int f(void); 
extern int b; 

int a = f(); 

int main() 

{ 

cout << b; 
return 0; 
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a2.cpp 


extern int a; 
int b = a; 

int f() 

{ 

return 3; 
} 
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You might expect that this two-module program would print "3". Sometimes it does, 
but it has a problem. Can you spot it? Call if you need a hint. Refer to Bug #1544. 
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While reading this book I fantasized what it would be like 
if the author suddenly found himself working at EDS, a soft¬ 
ware company astoundingly different from Microsoft in man¬ 
agement style and corporate culture. While Microsoft was hir¬ 
ing Ivy League graduates, EDS preferred people just out of the 
military who could take orders. While Microsoft encouraged 
creativity and freedom, EDS encouraged employees to spy on 
each other and report moral lapses or unapproved lifestyles. 
Yet, EDS has excelled at the one truly objective measure of 
Microsoft's success: revenues (EDS revenues dwarf those of 
Microsoft). Isn't it just possible that the "right" way to build 
software depends not only on the problem being solved, but 
the tools being used, and the people on the team? But who 
would buy a book that merely revealed that software develop¬ 
ment is hard and there are no easy answers? 

The last rule in the book is "Create a Winning Image," giv¬ 
ing this book the same self-referential feel that Gene Wang's 
by-the-way-we're-hiring job handbook has. If this book helps 
project the image that Microsoft makes "great" software (the 
foreword even breathlessly speculates that they may be mak¬ 
ing "historic software"), well, who can be blamed for a little 
company pride? A prophet is without honor in his own coun¬ 
try, so this book is probably better judged by someone who 
doesn't actually use Visual C++. When I read passages about 
empathizing with the customer and making the product easi¬ 
er to use, my plodding, detail-oriented brain kept thinking 
"isn't this the same team that invented the _decl spec() abom¬ 
ination, and that changed the linker so you have to include 45 
libraries just to build a Win32 program?" It's a relatively light 
read, and it gives you some insight into at least one develop¬ 
ment team at Microsoft, the one that may matter most to you if 
you're a C++ programmer. I think many of the principles 
espoused here could help some teams make better software. 
I'm just left with one question I stubbornly insist on asking in 
the face of all this talk about great people, great teams, great 
companies, great processes, and great software: how come 
there are so many bugs in Visual C++? 

Let's Talk Books 

Hello Ron, 

I am a French chemist who has invested lots of off-hours 
time in the past two to three years to get used to C and 
Windows programming. I can say that I have been able so far 
to achieve all the little applets I wanted to write for my own 
or professional use. However, it appears to me that today 
with the advent of stuff like VC 4,1 have no other choice than 
to try to get used to the C++/MFC/view/document infer¬ 
no!!! I tried to write toolbar apps in plain C and the task goes 
well beyond my poor little understanding. This is why I'm 
asking you if there's a good MFC-for-the-non-real-profes- 
sional-programmer book out there. I am a very enthusiastic 
reader and subscriber of WD/ and find myself very desperate 
when reading your book review columns!!! Looks like there's 
only cheap code listing type stuff being printed about VC++ 
and that doesn't really help poor guys like me. The advice of 
a real professional would probably help me achieve 20 per¬ 
cent of my personal migration strategy, should C++/MFC be 
the path for more than one year, so that I could start under¬ 
standing it. 


Many thanks for bringing very bright and useful info to 
occasional programmers like me with your excellent WDJ, 
and my best regards from cold France. 

Philippe Levi 

Maybe my standards are too high, but in my opinion the answer 
to your question is aflat "No." There are good task-oriented books 
that show you how to perform a whole bunch of little individual 
MFC tasks ( e.g"how to paint a bitmap as your dialog back¬ 
ground"). And most of the books describe the very highest level of 
MFC design, the idea of documents and views. But what's most 
important and completely missing from all the books I've seen is the 
middle ground — a solid description of the design of MFC, and how 
to design with MFC. 

I'm still looking though, so if you run across an MFC book you 
find really helpful, please let me knowl -rib 

From: George Mallard 
Subject: MFC Books 

I was reading your review of the latest Yao tailings and 
thought you might like a suggestion about MFC. I think that 
Yao is a good C programmer who hasn't made the transition 
to C++. At his talk at the MFC conference last year he passed 
out a document telling you why not to use MFC. Interesting 
that he's got a book now. 

The best description of the Document View I have found 
was in Heavy Metal FC++, by Steve Holzner. I don't like the title, I 
don't refer to the book, but I purchased it for Chapter 1. This 
means I gladly paid $40.00 for 34 pages. I only looked at this 
book because it got a review just like I gave you here. 

The best description of how all the pieces fit together can 
be found in an article series in MS] over that last months. 

The best C->C++ transition books, 

1) Appendix in Inside VC++ 

2) C++for Programmers 

I hope this helps. You have saved me time and $$ with your 
column. Thanks, GPM 

I agree the MSJ series is probably better at explaining design- 
level MFC information than most books, though I still await a good 
MFC book. Also, I think Allen Holub did an MFC article a while 
back that was good; I think he's teaching a class on MFC, so maybe 
that means a book from him is forthcoming. A dollar per page is pret¬ 
ty steep for information, but I guess I've done that myself sometimes! 
Thanks for the feedback! —rib 

I just read your review of Foundation of Visual C++ 
Programming. I am still looking for a good book on MFC. 
Recently I inherited and have been working on a large 
Borland Owl app, and I am slowly beginning to see the light, 
but I would still like to understand the design intentions of 
MFC. Why did the authors do what they did, and how did 
they really intend that MFC be used? Find me this book and 
I'll buy it! 

Have you read Windows++, by Paul DiLascia? He present¬ 
ed his class library from the bottom up (for the most part), so 
you felt like you understood (in fact, you felt like you worked 
with the author to develop the code) when you were done 
with the book. 


Page 38 — Windows Developer’s Journal 


May 1996 




but how 


"Sure. NT’s the 


Moving to Windows NT is a crucial step for your company. But how do you give up UNIX 
without sacrificing your budget, timelines and quality? Making the transition to a new 
development environment means changing and checking thousands of lines of code, 
usually without the necessary tools or training. 

Essential development tools for programmers 

The move from UNIX to NT doesn’t have to be expensive or time consuming. MKS 
customers do it everyday with MKS Toolkit. Rely on the KornShell on NT to move your 


* Graphical scripting for Win 32 

* Customizable toolbars for Windows 95 

* Enhanced NT security 

* Native 32 -bit utilities 


UNIX code over with minimal changes. Only MKS Toolkit's tape utilities allow you to read * CD ROM 


all your archived information onto your new NT machine, giving you the power to access 
and use stored information. 

The power of UNIX — on your PC 

Fortune Magazine’s top listed companies all use MKS Toolkit. Discover how MKS Toolkit 
can help you leverage your investment in your valuable code base. MKS Toolkit 5.1 is a 
comprehensive suite of 190+ software development utilities for the PC. You’ll find 
powerful new tools such as graphical scripting for Win32, customizable toolbars for 
Windows 95, and enhanced NT security support. 


oolkif. A developer’s best kept secret. 


Now supports Windows 95! (also available for DOS and OS/2) 


(C) 1995 MKS and MKS Toolkit are registered trademark of Mortice Kern Systems Inc. All other trademarks 
acknowledged. 


"MKS Toolkit turns Windows NT into a 
world-class set of commands and utilities. 
I wouldn't run without it." 

- Tom yager 

Open Computing Magazine 

Call today! 

1-800-265-2797 

http://www.mks.com 

MKS 

MORTICE KERN SYSTEMS INC. 


Programmer’s Paradise 800-445-7899 
The Programmer’s Supershop 800-421-8006 
PROVANTAGE 800-336-1166 
Software Spectrum 800-824-3323 
Stream 800-272-4559 


Mortice Kern Systems 

185 Columbia Street West 

Waterloo, Ontario N 2 L 5 Z 5 

Main: ( 519 ) 884-2251 

MKS Germany: * 49 711 16714 0 

MKS UK: *44 171 624 0100 

MKS Scandinavia: * 45 33 25 65 55 


□ Request Reader Service #137 □ 










If we could get Paul to "pretend" that he wrote MFC, and 
present it. I'm sure it would be a hit. 

David Dyck 
ssd@halcyon.com 

Sounds like you're looking for exactly the same thing in an MFC 
book that I am. I also liked DiLascia's book, and I think some 
unknown portion of the credit goes to the editor, Andrew Schulman. 
I wrote a small piece for Andrew once, so I know he has a knack for 
making authors answer all the questions their initial drafts uninten¬ 
tionally raise for the reader. I suspect if Paul wrote an MFC book and 
Andrew edited it, the result would be the best MFC book on the mar¬ 
ket. For now though, the "Petzold of MFC" has yet to arrive on the 
scene as far as I'm concerned! —rib 

Ron, 

Regarding your review of Microsoft Secrets in the March 
Windows Developer's Journal: weren't you pandering to the 
anti-Microsoft crowd just a wee bit? 

True, it's no big deal checking in code and fixing it when it 
breaks the build, but you didn't mention that Microsoft does a 
daily build. I don't believe many software companies do this. 

True, the authors had a "gee whiz" attitude about 
Microsoft, but they did mention that some practices which 
Microsoft called their own were really borrowed from IBM. 

True, Silverberg is probably ignorant about cross-platform 
development of embedded systems, but isn't porting in the 
large more difficult? Microsoft itself messed up the port of MS 


Word from Windows to the Mac. Word runs miserably slowly 
on the Mac and conspiracy theorists say Microsoft did it on pur¬ 
pose to hurt sales of the Mac — that is, so that companies would 
switch to a Wintel machine that runs a relatively fast MS Word. 

It's fashionable to bash Microsoft, but I find objectivity 
more useful. 

Mike Yam 

1 like to think I was bashing Microsoft long before it was fashion¬ 
able! In all seriousness, though, I’ve programmed under a number of 
operating systems over the years and I believe there is a natural con¬ 
flict of interest between programmers and operating system vendors. 
The programmer wants to avoid writing code tied to one platform; 
the vendor wants programmers to write code that only works with 
their product. The programmer wants to make maximal use of the 
operating system; the vendor wants programmers to stick to features 
that will be easy to maintain in the future. The programmer wants 
quality documentation and support; the vendor wants to maximize 
profits and spend as little on documentation and support as possible. 

In the case of Microsoft, this natural conflict is exacerbated by 
the fact that the operating system vendor also produces end-user 
applications (and programming tools, and Internet software, 
and...). This further decreases their incentive to do a good (rather 
than a "good enough") job serving programmers. Since I cut my 
teeth on software from Bell Labs and the University of Waterloo, 
I'm probably more critical of Microsoft "quality" than the average 

(text continued on page 73) 
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A Floating-Point Problem 

Mark Nelson 

Probably the scariest thing I have to do at work each day is to walk past Marc 
Leger's office. Since Marc's office is on the way to the men's room, I have a tough 
time avoiding it. This day was not to be one of the lucky ones — on a stealthy trip 
down the hall, I heard the familiar demand: "Mark! Mark! Come here, I need help!" 

Marc was running Turbo Debugger, and had a program similar to that shown in 
fpl.cpp (Listing 1). He was at work on a customer problem: a Greenleaf Database 
Library user was attempting to insert floating-point data into a database, and our 
library was returning an error code indicating a loss of precision. Marc was con¬ 
cerned for two reasons. First, he hadn't seen this problem before. Second, he couldn't 
reproduce the problem when using doubles, it occurred only with floats. 

Reproducing the Error 

The offending code is fairly simple. It converts a C++ double to ASCII representa¬ 
tion for storage in a database. After converting and storing the result, the code wants to 
see if the conversion process caused any loss of precision. For example, if I'm using 
two digits after the decimal point, I should get an error if I try to store 3.141. The trail¬ 
ing 1 would be lopped off by the binary to ASCII conversion done by sprintf (). 
Marc's test program from f pi. cpp (Listing 1) produced the following output: 

add_double( 1.12 ) returns success 
add_double( 1.125 ) returns failure 
add_double( d ) returns success 
add_double( f ) returns failure 

As expected, at two digits of precision, 1.12 is added to the database without error. 
But 1.125 fails, because it will be stored in ASCII as 1.12. Finally, using a double that 
has been assigned the value of 1.12 works properly. But using a float with a value of 
1.12 fails! 

The thing that was really bothering Marc was the display on his debugger. He 
was at the end of the add_doubl e( ) routine, and had all three local variables in his 
watch window. They all looked perfect. The two floating-point numbers had values 
of 1.12, and the character buffer contained a "1.12". Even so, the comparison 

test == d 

had just failed, causing the routine to return an error. Was the compiler somehow at 
fault? Marc was convinced it was a conspiracy on Borland's part to make his life hell. 

The problem was fairly simple, once you looked at it from the right perspective. 
Numbers such as 1.12 can't be represented exactly in a float, or even in a double. 
Thus, there are rounding and truncation errors when the conversion takes place. The 
specific problem in fpl.cpp (Listing 1) is the loss of precision found when placing 
1.12 in a float. Assigning that value to a double later on doesn't fix the problem, it 
only perpetuates it. 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the 
author o/The C++ Programmer's Guide to the Standard Template Library , from 
IDG Books, as well as The Data Compression Book , from M&T Books. You can reach 
Mark on the Web at http://web2.airmail.net/markn. 
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Listing 1 Demonstrating the problem caused by mixing floats and doubles 

II FP1.CPP 

// 

// 

if ( test — d ) 

// This is the test program that demonstrates 

return 1; //success 

// the problem found when mixing floats and 

else 

// doubles. The add double!) routine works 

return 0; //failure 

// properly for the constant 1.12, and for 
// the double 1.12. But when used with a 

> 

// float, it fails. 

// 

//include <iostream.h> 

main!) 

cout « "add double! 1.12 ) returns " 

//include <stdio.h> 

« ( add double! 1.12 ) ? "success" : "failure" ) 

//include <stdlib.h> 

« "\n"; 

// 

cout « "add double! 1.125 ) returns " 

// This routine converts a double to the 

« ( add double! 1.125 ) ? "success" : "failure" ) 

// ASCII representation needed for storage 
// in a database. After the conversion, 

« "\n"; 

// atofO is used to convert the value back 

double d - 1.12; 

// to binary representation. A check is done 

cout « "add_double( d ) returns " 

// to see if the ASCII and binary represntations 

« ( add double! d ) ? "success" : "failure" ) 

// match up. If they don’t it means that the 
// double is going to require more than 2 digits 

« "\n"; 

// of precision to represent properly. 

float f - d; 

// 

cout << "add double! f ) returns " 

int add double! double d ) 

<< ( add double! f ) ? "success" : "failure" ) 

{ 

char buf [ 81 ]: 

« "\n"; 

sprintf! buf, "%9.2f", d ); 

return 1; 

double test - atof( buf ); 

// 

// Some function here adds buf to the database 


//End of File 


In the add_double() routine, the 
actual value passed using a float is just 
a little bit off from the desired value of 
1.12. But when sprintfO formats the 


value to a buffer using just two digits of 
precision, the error is eliminating by 
rounding. Thus, when at of () converts 
the buffer back to a double, the error is 


gone. This means that the input value 
and the test value are going to differ by 
a small amount. 

fp2.cpp (Listing 2) contains a pro¬ 
gram that demonstrates how this 
works, dl is a double that has been ini¬ 
tialized with the value of 1.12. d2 has 
the same value after being initialized 
using a float. The output of the program 
is shown below. 

f - 1.12 1.120000005 dump: 29 5c 8f 3f 

dl - 1.12 1.12 dump: ec 51 b8 le 85 eb fl 3f 

d2 - 1.12 1.120000005 dump: 00 00 00 20 85 eb fl 3f 

As you can see, looking at all three val¬ 
ues at just three digits of precision 
makes them seem identical. However, 
when you use a greater precision, the 
representation error of a float rears its 
ugly head. The binary dump of the sec¬ 
ond double shows exactly where the 
problem lies. The lower half of the dou¬ 
ble contains all zeros, a result of having 
the smaller float value copied into it. 
Clearly, given the comparison 

test — d 

in f pi. cpp (Listing 1), the compiler will 
notice the difference. 

The Resolution 

Marc wasn't particularly happy with 
my explanation. First, it didn't offer an 
immediate solution to his problem. And 
second, he resented my glib advice: 
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Listing 2 Showing the binary representation of some values used in fpl.cpp 

// FP2.CPP 

cout.filK ’O' ); 

// 

cout « ”f - M « setprecision( 3 ) « f 

// This program is used to dump the binary representation 

« ” ” « setprecisi on ( 10 ) « f 

// of a few different values used in FP1.CPP. 

« ” dump: ”: 


dump( f ); 

#include <iostream.h> 

cout « "\n”: 

//include <iomanip.h> 


//include <stdlib.h> 

cout « "dl - " « setprecision( 3 ) « dl 


« " " « setprecision( 10 ) « dl 

tempiate<class T> void dump( T it ) 

« " dump: 

t 

dump( dl ); 

unsigned char *p - (unsigned char *) it: 

cout « "\n"; 

for ( int i - 0 ; i < sizeof ( T ) ; i++ ) 


cout « setw( 2) « hex « (int) *p++ « ’ 

cout « "d2 - " « setprecision( 3 ) « d2 

j 

« " " « setprecision( 10 ) « d2 


« " dump: 

mainO 

dump( d2 ); 

f 

cout << "\n": 

float f - 1.12; 

return 0; 

double dl - 1.12; 

i 

double d2 - f; 



//End of File 


"Never use floating-point numbers if you expect your pro¬ 
gram to work." 

The best answer for our customer would have been to keep 
all floating-point data in doubles at all times. Unfortunately, 
this solution was impractical. Instead, we created a short rou¬ 
tine for her that simply rounded off doubles to two significant 
digits, throwing out anything beyond that. Life would have 
been much easier if we could have convinced her to simply 
ignore the error return! 


My advice to you is the same: avoid floating point anytime 
it isn't really necessary. If you do find you need to use it, try to 
avoid mixing doubles and floats. Stick to the preferred C++ 
floating format of double for all your data and calculations, 
and maybe you'll avoid those moments of hysteria that Marc 
has to constantly deal with. □ 
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Understanding NT 


I/O Completion Ports 

Paula Tomlinson 



Last month, I discussed general multithreaded program¬ 
ming issues. Among other things, I explained how to choose 
the optimal number of worker threads for a client/server 
application (or any application that can easily and naturally 
divide its own tasks into multiple worker threads). One tradi¬ 
tional approach is to use one worker thread to handle all 
client requests. In this case, requests can only be processed 
one at a time. Not only is this inefficient on multiprocessor 
systems, it also misses out on the opportunity to process 
other requests while a particular request is blocked (such as 
waiting for an I/O operation to complete). Another tradition¬ 
al approach is to use a separate worker thread for each client. 
While this method takes better advantage of multiprocessor 
systems and blocked threads, it can incur excessive overhead 
due to thread context switching if there are many clients. 

As I mentioned last month, a rule of thumb is that the opti¬ 
mum number of worker threads is equal to the number of 
processors in the system plus a few extra threads to make sure 
there are runnable threads even if some other threads are 
waiting. Though this approach is the most efficient in terms of 
minimimizing thread context switching and maximizing 
processor utilization, it also tends to be more complicated to 
implement than the more traditional approaches. I/O comple¬ 
tion ports were introduced into NT (they are not available 
under Windows 95) to make it easier to design applications 
that use a small number of threads to handle a potentially 
larger number of I/O operations. 

Overlapped I/O 

I/O completion ports first appeared in Windows NT 3.5. 
Since they work in conjunction with overlapped 1/O, I'll first 


review how overlapped (asynchronous) I/O works on 
Windows NT. Windows NT supports overlapped I/O not just 
on disk-based files, but also on pipes, sockets, and serial and 
parallel devices, as well as any other standard 1/O device (it's 
up to the device driver for that device to support asynchro¬ 
nous I/O or not). Since the standard Win32 file I/O routines 
are often used to communicate with each of these devices, I 
will use the term "file" to apply to any of them. 

The Win32 API provides two mechanisms for performing 
basic overlapped file 1/O. In both cases the file handle must be 
opened with the FILE_FLAG_OVERLAPPED flag. One method is to 
use a completion routine. In this case, your application calls 
ReadFileExO and WriteFileExf ), specifying the address of a 
completion routine and an initialized OVERLAPPED data struc¬ 
ture. ReadFi 1 eEx( ) and WriteFi leEx( ) will return immediately. 
The caller can then proceed to do other work, but to retrieve 
the results of the I/O, the caller must eventually call one of the 
Win32 wait routines to wait for the event whose handle was 
passed to ReadFileExO or WriteFi 1eEx( ) to be signaled. When 
your application is ready to receive the data, it enters an 
alertable state by calling one of the avertable Win32 wait rou¬ 
tines (WaitForSingleObjectEx, Wa i tForMultipieObjectEx, and 
SleepEx). When the I/O operation is completed, the comple¬ 
tion routine is called. Refer to Figure 1 for the definition of the 
OVERLAPPED data structure. 

The second method involves using ReadFi let) and 
WriteFi 1 e () along with an OVERLAPPED structure. You can 
either fill in a valid manual-reset event handle in the h Event 
field of the OVERLAPPED structure or set that field to NULL and 
simply wait on the file handle itself. Waiting on the file handle 
means you can only queue one overlapped I/O request at a 
time to a given file, so it's more common to wait on the event 
handle instead. Although you can use WaitForSingleObjectt) 
to wait on the event handle directly, you will ultimately need 
to call GetOverl appedResul t() anyway, to find out how many 
bytes of data were actually transferred. By passing a value of 


Paula Tomlinson has been developing DOS, Windows and Windows-NT based applications and device drivers for eight years. The opin¬ 
ions expressed here are hers alone. She can be contacted via the internet at paulat@microsoft.com. 
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TRUE as the last parameter to GetOverl appedResul t( ), you can 
perform a wait and a retrieval of the transferred byte count all 
in one operation. A typical code fragment for performing 
overlapped I/O using this method might look like this: 

OVERLAPPED Ov; 

Ov.Offset = Ov.OffsetHigh = 0; 

Ov.hEvent = CreateEventtNULL,TRUE,FALSE,NULL); 

hFile = CreateFi1e(_FILE_ATTRIBUTE_NORMAL 

| FILE_FLAG_OVERLAPPED.NULL); 

if (!WriteFile(hFile.&0v) 

&& GetLastErrorO != ERRORJO.PENDING) { 

// error 

} 

// do some other work... 

II... 

II then block until the I/O completes: 

GetOverlappedResult(hFi 1 e,&0v,&Bytes.TRUE); 


Although you can build complex client/server applications 
using these simple overlapped I/O mechanisms, I/O comple¬ 
tion ports are particularly well suited for the case where a 
smaller set of worker threads needs to service a potentially 
larger (or variable) number of client requests. 


I/O Completion Ports 

Figure 2 contains a schematic that may be helpful as you 
read the following description. To use 1/O completion ports, 
you still open file handles and read and write to them in 
much the same way as you would for traditional overlapped 
I/O. The real power of completion ports is in how you wait 
for the completion of the overlapped I/O operations. 
Completion ports are essentially a new synchronization 
mechanism. The first step is to create the I/O completion port 
by calling CreateIoCompletionPort(). This routine takes as 
parameters a file handle and (optionally) the handle of an 
existing completion port. Consider the case where you have 
three file handles (remember, these could just as easily be 
named pipes) that you want to queue overlapped I/O 
requests to and only two threads to process all three requests. 
You can associate all three file handles with the same comple¬ 
tion port handle by making the following calls: 

hPort = CreateloCompletionPortthFi1 el. NULL, 0, dwMaxThreads); 
CreateloCompletionPort(hFile2, hPort, 0, dwMaxThreads); 
CreateloCompletionPort(hFile3, hPort, 0, dwMaxThreads); 


Figure 1 Windows NT 
I/O completion port data 
structures and API routines 


typedef struct ..OVERLAPPED { 

DWORD Internal; 

DWORD Internal High; 

DWORD Offset; 

DWORD OffsetHigh; 

HANDLE hEvent; 

) OVERLAPPED; 

HANDLE 

CreateloCompletionPortl 
HANDLE FileHandle, 

HANDLE ExistingCompletionPort, 

DWORD Completionkey, 

DWORD NumberOfCurrentThreads 
); 

BOOL 

GetQueuedCompletionStatusI 
HANDLE CompletionPort, 

LPDWORD 1pNumberOfBytesT ransferred, 
LPDWORD 1pCompletionKey, 
LPOVERLAPPED *1pOverlapped, 

DWORD dwMi Hi seconds 
); 

BOOL 

PostOueuedCompletionStatust 
HANDLE CompletionPort, 

DWORD dwNumberOfBytesCompleted, 
DWORD dwCompletionKey, 

LPOVERLAPPED lpOverlapped 
); 



May 1996 


Windows Developer’s Journal — Page 45 

















































































Now that you've created the completion port and associated 
all the file handles with it, each of the two threads can wait on 
this single completion port handle. Note that you also specify 
how many threads associated with the port can be executing 
concurrently. If you specify zero for this parameter, the system 
will automatically use a concurrency value equal to the num¬ 
ber of processors. A waiting thread will then be released if (1) 
any overlapped I/O operation to any of the associated file 
handles completes and (2) the number of associated running 
threads is less than the specified thread concurrency value for 
the port. 

An example can show how the I/O completion port con¬ 
currency value helps optimize your use of threads. Suppose 
you have a two-processor system and you therefore decide to 
have just two threads service your 1/O completion port. Now 
suppose that both of your threads are busy handling I/O com¬ 
pletion packets when a new I/O completion packet arrives. 


Listing 1 

wdjjocp.h — Common definitions 

// wdjjocp.h 


#define PIPE NAME 

TEXTC'WW.WpipeWwdj iocomp") 

//define READ BUFFER 

MAX PATH * sizeof(TCHAR) 

//define WRITE BUFFER MAX PATH * sizeof(TCHAR) 

/* End of File */ 


Listing 2 clnt.c — A named pipe client pro¬ 
gram 


II clnt.c 

//include (windows.h> 

#include <tchar.h> 

//include "wdjjocp.h" 

void main(void) 

1 

HANDLE hPipe; 

DWORD dwMode - PIPE_READMODE_MESSAGE | PIPEJAIT; 

TCHAR RdBuffer[MAX_PATH], WrBuffer[MAX_PATH]; 
int i, Size; 

DWORD dwProcessId - GetCurrentProcessIdO; 

if (!WaitNamedPipe(PIPE_NAME, 5000)) return; 

hPipe - CreateFile(PIPE_NAME. GENERIC_READ|GENERIC_WRITE, 
0, NULL, 0PEN_EXI$TING, FILE_ATTRIBUTE_N0RMAL, NULL); 

SetNamedPipeHandleStatethPipe, SdwMode, NULL, NULL); 

for (i=0; i < 5000; 1++) { 

wsprintf(WrBuffer,TEXTC"Client-%d-%d"),dwProcessId,i); 
Size = (1strlen(WrBuffer)+l) * sizeof(TCHAR); 

if (!TransactNamedPipe(hPipe, SWrBuffer, Size, 

RdBuffer, READ_BUFFER, SSize, NULL)) { 
CloseHandle(hPipe); 
return; 

1 

_tprintf(TEXT!"Client: %s, %d\n"), RdBuffer, Size); 

1 

CloseHandle(hPipe); 

1 

/* End of File */ 


It's okay that the new I/O packet has to wait, since starting a 
new thread to service it would simply interrupt one of the two 
currently running threads (there are only two processors, after 
all); there would be no real increase in throughput. But what if 
one of the two existing threads has to write something to disk 
as part of its work? At that point, only one of your two threads 
is doing useful work, while the other one is blocked. Having 
another thread to service the new I/O packet makes sense 
here, since that would bring the number of threads actively 
servicing the port back up to two. 

That's what the 1/O completion port concurrency setting 
does for you. If you only want two threads servicing the port 
at a time, but you know that your threads may get blocked 
one or more times before they come back to service another 
I/O completion packet, then you can start several threads 
(say, four), but at the same time specify a concurrency value of 
only two when you create the I/O completion port. That way, 
if two threads are busy handling I/O completion packets, but 
one of them gets blocked for some reason, the 1/O completion 
port will allow one of the two remaining waiting threads to 
have the next packet. This strategy can help you get closer to 
the ideal of always having n threads running, where n is the 
number of processors in the system. Note that this is still help¬ 
ful even on a single-processor system. 

The Win32 routine you use to wait on a completion port is 
GetQueuedCompl etionStatust). You can think of 
GetQueuedCompletionStatus( ) as roughly the equivalent of 
calling GetOverl appedResul t( ). Before I get into the details of 
these routines, let me first discuss the other special attributes 
of I/O completion ports. 

An additional significant advantage of using I/O comple¬ 
tion ports over standard overlapped 1/O is the way waiting 
threads are released. With normal overlapped I/O (or any 
other synchronization method, for that matter), waiting 
threads are released in first-in/first-out order. With a comple¬ 
tion port, however, waiting threads are released in last 
in/first out order. Why does this matter? All the threads wait¬ 
ing to service the port are equivalent, but the one that most 
recently requested an 1/O completion packet is least likely to 
have any memory resources swapped out to disk. 
Conversely, the thread that has been waiting the longest is 
most likely to have some memory swapped out to disk. Since 
any thread can handle the request, the 1/O completion port 
gives it to the thread that was most recently running, in the 
hopes of minimizing any page faults. 

Another advantage is that the number of queued I/O 
requests to a completion port is really only limited by avail¬ 
able system resources. Wai tForMul ti pi eObjects (), on the other 
hand, can only wait on up to MAXIMUM_WAIT_0BJECTS (currently 
defined as 64) events. 

I/O completion ports can be used on any valid handle that 
was opened for OVERLAPPED transfers. Examples of Win32 rou¬ 
tines that can be used to communicate with such a handle are: 
ReadFileO, WriteFileO, DeviceloControl (), WaitCommEventt), 
ConnectNamedPi pe(), T ransactNamedPi pet ),and LockFileExO. 
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Using I/O Completion Ports 

I wrote a simple application in which a client and server 
communicate via a named pipe to demonstrate using I/O 
completion ports in a fairly realistic scenario. wdj_iocp.h 
(Listing 1) is the common include file that both the client and 
server will reference. It defines the name of the pipe and the 
maximum read and write message sizes (the named pipe will 
operate in message mode as opposed to byte mode for both 
client reads and client writes). 

clnt.c (Listing 2) contains a sample client application. Of 
course there is no need for the client to be aware of the fact 
that the server will be implemented using I/O completion 
ports. The client simply calls WaitNamedPipe( ) to wait for an 
instance of the named pipe to become available. Once an 
instance of the pipe is available, the client connects to it by 
calling CreateFi 1 e( ). Note that, for simplicity, the client com¬ 
municates with the named pipe in a synchronous fashion 
(FILE_FLAG_OVERLAPPED is not specified in the CreateFi 1 e() 
call). Then the client simply goes into a long loop, calling 
TransactNamedPipe(). TransactNamedPipe( ) performs both a 
synchronous ReadFileO call and a synchronous WriteFileO 
call before returning. The format of the message includes a 
request ID as well as the process ID, so that you can see which 
requests are going into the server if multiple instances of this 
client are running. 

The typical strategy for the server is to create one handle 
(in my case, this would be a handle to an instance of a named 


pipe) for each client and associate each handle with a single 
I/O completion port. Whenever a new handle is created, an 
initial read is queued to that handle to effectively put the serv¬ 
er side of the pipe in a "listening" state. Each worker thread 
then waits on the I/O completion port. When an I/O request 
completes, one of the worker threads (it doesn't matter which) 
is released. The worker thread processes the requests and 
queues another read request before waiting again on the com¬ 
pletion port. 

In serv . c (Listing 3), the main thread first creates a tempo¬ 
rary file handle so that it has a valid handle to use in creating 
the initial completion port. Note that under Windows NT 3.5 
you are required to specify a valid handle in the FileHandle 
parameter, but under Windows NT 3.51 and above, you can 
specify I NVALID_HANDLE_VALUE as the FileHandle parameter. 
The main routine then creates all the worker threads. As I 
mentioned last month, a value of twice as many worker 
threads as there are processors in the system is a simple and 
efficient choice. Also note that I specify a value of zero for the 
concurrency value which uses a value equal to the number of 
processors (half the number of total threads should be run¬ 
ning simultaneously). 

The main routine then goes into a loop waiting for new 
clients. It does this by creating an instance of the named pipe 
and associating that pipe handle with the completion port. I 
also allocate a small piece of memory (the MYCONTEXT struc¬ 
ture) and pass a pointer to that memory in the Comp! eti ortKey 
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parameter. This parameter is file handle-specific information 
that will be returned when GetQueuedCompletionStatus() 
returns. Any information that you will need later to identify 
which request has actually completed needs to be incorporat¬ 
ed into this context information. I embedded the pipe handle, 
the overlapped structure, and the read and write buffers in the 
MYCONTEXT structure. 

The main routine then waits for a client to connect by call¬ 
ing ConnectNamedPipe( ). Once a client has connected to an 
instance of the pipe, I perform an initial read to that instance 
of the pipe. The initial read essentially puts the pipe in a lis¬ 
tening mode. If the client breaks its connection to the pipe 
between my calls to ConnectNamedPipe( ) and ReadFi 1 e( ), then 


I will get an E RROR_PIP E_B ROKEN message from GetLastErrort ). 
In this case, since the pipe handle is still valid and has already 
been associated with the completion port, I can reuse the pipe 
instance and the context structure and go immediately to 
waiting for a new client to connect. 

Since there is only one completion port, I passed the com¬ 
pletion port handle to each instance of WorkerThreadf ) as the 
thread parameter. WorkerThread( ) immediately calls 
GetQueuedCompl eti onStatus () to wait for the completion of an 
1/O request to any pipe instance that has been associated with 
this completion port. WorkerThread () gets all the other infor¬ 
mation it needs from context information that was passed in 
during the call to CreateloCompl etionPortl ). To verify receipt 
of the client request, I print out a mes¬ 
sage to the screen. Then I uppercase the 
message and write it back to the client. 
This is where it gets a little interesting. 

My worker thread needs to write 
something back to the same pipe that 
incoming requests are arriving on. 
However, that pipe handle is associat¬ 
ed with an I/O completion port, so if I 
write to it, an I/O completion packet 
will be queued up and handed to the 
next worker thread — which is 
expecting to receive only incoming 
client requests, not outgoing respons¬ 
es to client requests! Clearly, I need a 
way to write to the pipe without 
accessing the I/O completion port 
mechanism. 

This is not an uncommon scenario, 
so NT does provide a way to perform 
an I/O to a file handle that bypasses 
whatever 1/O completion port that file 
handle is associated with. To bypass the 
completion port, use a separate over¬ 
lapped structure with a separate manu¬ 
al reset event. The trick is to set the low 
bit of the event handle to 1 (the two 
low-order bits of the handles are never 
used for the actual handle value). This 
prevents the completion port from sig¬ 
naling when the request completes. 
After writing the response message 
back to the client, WorkerThread( ) issues 
another overlapped read on the pipe, 
which puts it back into a listening 
mode. 

If worker threads detect that a client 
has disconnected from the pipe (by 
receiving an ERR0R_P I PE_BR0KEN error 
after calling ReadFi le() or 
Wri teFi 1 e()), then you would probably 
want to reuse the existing pipe and 
context structure for the next client that 
attempts to connect. However, you 
don't want to block the worker threads 
to wait for a client to connect. Although 
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I don't handle this in my simple example, a better approach 
would be to have a separate thread that handled all incoming 
client connections and that reused any pipe handles and con¬ 
text structures from previously disconnected pipe instances. 

For simplicity, I used an infinite timeout on my calls to 
GetQueuedCompl etionStatus (). If you do specify a timeout 
value on the call to GetQueuedCompl eti onStatus () and the 
timeout is exceeded before an operation completes, then 
GetQueuedCompl etionStatusO will return FALSE and 
GetLastError () will return WAIT_TIMEOUT (258). 

Another interesting feature of completion ports that I did 
not demonstrate in my example is 
PostQueuedCompletionStatusO. This routine was introduced 
in Windows NT 3.51. You can use this routine to send your 
own private completion packet to the completion port with¬ 


out having to issue a real I/O operation. This is a very handy 
routine for implementing an internal communication mecha¬ 
nism between your worker threads. 

Summary 

I/O completion ports provide an efficient mechanism 
for performing overlapped I/O with multiple threads. 
Although I demonstrated using I/O completion ports with 
client and server applications, they can sometimes be use¬ 
ful in standalone applications. Any application that per¬ 
forms a lot of I/O may be a candidate for using completion 
ports. For example, you could use completion ports to 
implement efficient file copying. First, associate both the 
source and destination file with a completion port and then 
issue a number of overlapped read requests to the source 


Listing 3 serv.c — A named pipe server program 


// serv.c 

(/include <windows.h> 

(/include <mal1oc.h> 

(/Include <tchar.h> 

(/include "wdjjocp.h" 

(/define MAX_CLIENTS 20 

(/define TEMP_FILE TEXT("~wdjplt.tmp") 

typedef struct MYC0NTEXT_s { 

OVERLAPPED Ov; 

TCHAR ReadBuffer[MAX_PATH]: 

TCHAR WriteBuffer[MAX_PATH]: 

HANDLE hPipe; 

} MYCONTEXT, *PMYC0NTEXT; 

DWORD WorkerThreadtHANDLE hPort); 

void main(void) 

{ 

SYSTEMJNFO Syslnfo; 

HANDLE hPipe, hPort, hTemp, hThread; 

DWORD i, Size, dwMaxThreads, ThreadID; 

PMYCONTEXT pContext; 

// calculate number of worker threads to create 
GetSystemlnfot&SysInfo); 

dwMaxThreads = Syslnfo.dwNumberOfProcessors * 2; 

// create temp file just to create the io comp port 
hTemp = CreateFile(TEMP_FILE, GENERIC_READ | GENERIC_WRITE, 
0, NULL, CREATE_ALWAYS, FILE_ATTRIBUTE_NORMAL | 
FILE_FLAG_OVERLAPPED, NULL); 

if ((hPort = CreateloCompletionPort(hTemp, NULL, 0, 

0)) — NULL) return; 

// create the worker threads 

for (i - 0; i < dwMaxThreads; i++) { 

if ((hThread = CreateThreadtNULL, 0, WorkerThread, 
(LPVOID)hPort, 0, SThreadlD)) != NULL) ( 

CloseHandle(hThread); 

1 

1 

while(TRUE) { 

// create an instance of the pipe for the next client 
hPipe = CreateNamedPipe(PIPE_NAME, 

PIPE_ACCESS_DUPLEX | FILE_FLAG_0VERLAPPED, 
PIPE_TYPE_MESSAGE | PIPE_READM0DE_MESSAGE | 
PIPEJAIT, MAX_CLIENTS, WRITE_BUFFER, 


READJUFFER, 5000, NULL); 

// create context structure for next client 
pContext = mal1oc(sizeof(MYCONTEXT)); 
pContext->hPipe = hPipe; 

pContext->0v.Offset - pContext->0v.OffsetHigh - 0; 
pContext-SOv.hEvent = NULL; 

// associate the new pipe instance with the port 
hPort = CreateloCompletionPort(hPipe, hPort, 
(DWORD)pContext, dwMaxThreads); 

AcceptNewClient: 

// wait for the next client to connect 
if (ConnectNamedPipe(hPipe, NULL) || 

GetLastErrorO — ERR0R_PIPE_C0NNECTED) { 

// issue a read to the port to start listening 
if ((!ReadFi1e(hPipe. pContext-SReadBuffer, 
READ_BUFFER, ASize, &pContext->0v)) 

U (GetLastErrorO !- ERR0R_I0_PENDING)) { 
if (GetLastErrorO -= ERR0R_BR0KEN_PIPE) ( 

DisconnectNamedPipethPipe); 
goto AcceptNewClient; 

} else { 

DisconnectNamedPipe(hPipe); 
CloseHandle(hPipe); 
free(pContext); 

1 

1 

} else { 

CloseHandle(hPipe); 

CloseHandle(hTemp); 

DeleteFi1e(TEMP_FILE); 

1 

1 

1 

DWORD WorkerThread(HANDLE hPort) 

{ 

DWORD Bytes; 

PMYCONTEXT pContext; 

LP0VERLAPPED pOv; 

OVERLAPPED Ov; 

Ov.Offset - Ov.OffsetHigh = 0; 

Ov.hEvent - CreateEvent(NULL, TRUE, FALSE, NULL): 
Ov.hEvent - (HANDLE)((DWORD)Ov.hEvent | 0x00000001); 

while (TRUE) { 

if (!GetQueuedCompletionStatus(hPort, XBytes, 
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Listing 3 continued 


(LPDWORD)&pContext, &pOv, (DWORD)-l)) { 
DisconnectNamedPipe(pContext->hPipe): 

// reuse the pipe and context structure to 
// wait for a new client (but not here) ... 
continue; 

} 

_tprintf(TEXTC'Server: its, %d\n"), 
pContext->ReadBuffer, Bytes); 

CharUpper(pContext-)ReadBuffer); 

if((!WriteFi1e(pContext->hPipe, pContext->ReadBuffer, 
Bytes. &Bytes, &0v)) 

&& (GetLastErrorO !- ERROR_IO_PENDIN6)) { 

DisconnectNamedPipe(pContext->hPipe); 

// reuse the pipe and context structure to 
// wait for a new client (but not here) ... 
continue; 

} 

if ((!ReadFi1e(pContext->hPipe, pContext->ReadBuffer, 
READ_BUFFER, &Bytes, &pContext->0v)) 

M (GetLastErrorO 1- ERROR_IO_PENDING)) { 
DisconnectNamedPipe(pContext->hPipe); 

// reuse the pipe and context structure to 
// wait for a new client (but not here) ... 
continue; 



return TRUE; 

) 

/* End of File */ 


file. Then one or more threads can wait on the completion 
port. Whenever a read operation completes, the thread 
would write that data to the destination file. Whenever a 
write operation completes, the thread would issue another 
read request to the source file. 
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Bug++ of the Month 

Mark Nelson 


If you discover a bug in the latest version of your favorite compiler, 
email it to us at wdletter@rdpub.com. Please specify which version 
of your compiler you are using and include the smallest possible 
program that demonstrates the problem, along with the exact com¬ 
mand-line options needed to compile it. 

Regular readers of this column will know that the new 
placement syntax has caused a fair amount of trouble for C++ 
compiler writers ("Bug++ of the Month," Oct. 1995). This C++ 
feature is used by libraries such as the STL to construct objects 
in memory buffers designated by the caller. 

Normal calls to the constructor for a C++ object cause an 
implicit call to the global new operator, new creates a buffer of 
the correct size, then passes that buffer to the constructor. In 
other words, a call like this: 

CFoo *p = new CFoo; 

generates code that acts something like this: 

CFoo *p 

p = (CFoo *) new chart si zeof( CFoo ) ]; 
if ( p !- 0 ) 

CFoo::CFoo( p ); 

Of course, each compiler does this in its own fashion, but the 
pseudo-C++ code above at least gets the idea across. 

Using the new Placement Syntax 

But what if you want to dynamically allocate memory in a 
buffer of your own? Maybe you don't trust the C++ memory 
allocation routines. Or maybe you want to use shared memo¬ 
ry, or an EMS buffer. You can accomplish any of these things 
by using the new placement syntax, in conjunction with a spe¬ 
cialized version of new that you provide. 

For example, if I want to be able to create CFoo objects in 


raw memory buffers, all I have to do is write a new operator 
that looks like this: 

void *operator new( unsigned int, char *p ) 
return p; 

} 

Then, I can write code that looks like this: 

buffer chart 1000 ]; 

main() 

{ 

CFoo *p = new( buffer ) CFoo; 

to generate code that acts like this: 

CFoo *p 

p = (CFoo *) newt sizeof( CFoo ), buffer ); 
if ( p != 0 ) 

CFoo::CFoo( p ); 

Destroying Objects 

Destroying objects created using the placement syntax 
requires a call to the explicit destructor. A call like this: 

p->~CFoo(); 

tells the compiler to call the destructor for the object without 
calling the global delete operator to free the memory. If the 
compiler tried to delete the memory buffer for an object creat¬ 
ed using the new placement syntax, it would probably generate 
code that corrupted the heap, or worse. 

Microsoft's Method 

For both its 16- and 32-bit compilers, Microsoft handles the 
two types of destructors by using a wrapper function. A call to 
the destructor for an object actually generates a call to the 


Mark Nelson is a programmer for Greenleaf Software in Dallas, Texas. Mark is the author o/The C++ Programmer's Guide to the 
Standard Template Library, from IDG Books, as well as The Data Compression Book, from M&T Books. You can reach Mark on the 
Web at http://web2.airmail.net/markn. 
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Listing 1 bug0596.cpp 


// 

// BUG0596.CPP 
// 

// This bug demonstrates a very bad problem 
// in VC++ 2.2. When explicity calling 
// a virtual destructor, VC++ forgets to push 
// an integer flag parameter on the stack. The 
// compiler generated scalar destructor routine 
// expects it. Two things happen because of 
// this. First, the scalar destructor routine might 
// call -delete for memory not on the heap, depending 
// on the random memory contents on the stack. Second, 
// when the scalar destructor routine exits, it will 
// have adjusted the stack by an extra four bytes, since 
// it expects to have a flag parameter. Thus, ESP is no 
// longer valid upon return, which is catastrophic! 

// 

// Built using VC++ 2.2: cl bug0596.cpp 
// 

// - or - cl /Ox bug0596.cpp 

II 

//include <iostream.h> 

//include <iomanip.h> 

//include <stdlib.h> 

// 

// Class foo has a virtual destructor 
// 

class CFoo 
{ 


public: 

CFoo(){ cout « "ctor 

« (void * ) this 
« "\n"; } 

virtual ~CFoo(){ cout « "dtor 

« (void *) this 
« "\n"; } 

}; 

// 

// This operator new is necessary to support 
// the placement syntax. When you call the 
// new operator using placement syntax, it 
// will call this routine to get the address 
// it should use to construct the new object. 
// 

void ‘operator new( unsigned int, char *p ) 

{ 

return p; 

} 

// 

// Later in the example I create a new object 
// in this memory buffer using the new 
// placement syntax. 

// 

char bufferC sizeof( CFoo ) ]; 

// 

// I create my own version of 


wrapper function, known as the scalar deleting destructor. In 
theory, the wrapper function will act as if it was coded this 
way: 


CFoo::'scalar deleting destructor't CFoo *this, int flag ) 

{ 

CFoo::~CFoo( this ); 
if ( ( flag & 1 ) — 1 ) 

::delete (char *) this; 

} 
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Listing 1 continued 


// the global delete operator so I can 
// catch an attempted delete of the 
// above buffer. 

// 

void operator delete( void *p ) 

{ 

cout « "Deleting " « p; 
if ( p — (void*) buffer ) 
cout « " - Error!\n"; 

else 

cout « " - Ok!\n"; 

} 

void foo() 

{ 

int entry_sp; 

_asm mov entry_sp,esp 

cout « "Stack pointer entering food - " 

« hex « (void*) entry_sp « "\n"; 

// 

// The standard new/delete combination works properly. 

// If you compile with /Fc, you will see that the 
// destructor call pushes a T on the stack before 
// calling CFoo::'sealar deleting destructor' 

II 

CFoo *pf - new CFoo; 
delete pf; 

// 

// When I create an object using the placement syntax, 

// the ctor correctly constructs an object in the buffer 
// I pass to new. However, when calling the destructor, 

// the compiler forgets to generate a 'push O' instruction, 
// which is expected by CFoo::'sealar deleting destructor’. 
// Since the destructor uses a pascal-like calling 
// convention, it will clean up the stack even though no 
// arguments were passed on it, leading to an invalid 


// stack pointer upon return. 

// 

pf - new ( buffer ) CFoo; 

pf->~CFoo(); 

int exit_sp; 

_asm mov exit_sp, esp 

cout « "Stack pointer exiting foo() - " 

« hex « (void*) exit_sp « "\n"; 
if ( entry_sp !- exit_sp ) { 
cout « "Aborting!\n"; 
cout.flushO; 
abortO; 

} 

} 

// 

// The main routine has one tricky bit. 

// When CFoo::'sealar deleting destructor’ is 
// called with no argument, it pulls a random 
// value off the stack. As it happens, that random 
// value will be the saved value of edi or esi 
// as passed to foo(). I can force that ’random* 

// value to be a 1 by setting both registers to 
// that value in mainO. 

// 

main() 

{ 

cout « "Calling foo()\n”; 

_asm mov esi, 1 
_asm mov edi, 1 
foo(); 

cout « "Returning from fooONn"; 
return 1; 

} 

//End of file 


The key point to note here is that the 
wrapper function only deletes the mem¬ 
ory allocated for the object if the flag 
argument has bit 0 set. Otherwise, it just 
leaves the memory in place. 

This means that a normal call to the 
destructor (e.g., del ete p) will generate 
code that looks something like this: 

push 1 
push p 

call CFoo::’scalar deleting destructor’ 

A call to the explicit destructor (e.g., p- 
>~CFoo()) will generate code that looks 
something like this: 

push 0 
push p 

call CFoo::’scalar deleting destructor’ 

Reality Check 

The designers of Visual C++ 2.1 
decided to bypass the wrapper function 
when faced with an explicit destructor 
call. They were able to save one instruc¬ 
tion by generating this code instead: 

push p 

call CFoo::~CFoo() 


M BASH • PERL • LESS * SAMBA • EMACS |j j 


I 

o 

GREAT 

GZIP 

o 

1- 

UNIX SOFTWARE 

• 

• 

< f ,) 
o 

FOR WINDOWS 95! 

SED 

tr 

Ready-to-Run Software, the acknowledged leader in Unix ® 
porting, announces the collection of Unix software that you've 

• 


been waiting for to enhance your Windows ^productivity. 

o 

J3 

D 

z 

• Ready-to-run with fast, easy installation 

"0 

LL 

• Low-cost support available 

• 

• 

• Complete with HTML documentation 


w 

• Value-priced at $79.95! 

T1 

C5 

z 

Our Win95Pak contains over one hundred executable programs 

• 

IT 

including a simple telnet daemon and others too numerous to 


!/> 

mention. Check out our web page for a complete list. 

C 0 
O 

• 

^ M CALL FOR A FREE CATALOG 

H 

JOIN 

fl 1 - 800 - 743-1723 

• 

D 

• 

Ready-to-Run Software, Inc. 

O 


A ^ ii 4 Pleasant Street, Forge Village, MA 01886 

R C a 0 N Phone: (508) 692-9922 FAX: (508) 692-9990 

• 

cc 

f 0 5 a fl E WWW; http://www.rtr.com email: info@rtr.com 


1— 

$ 0 ^ The Ready-to-Run Software logo ii a registered trademark of Ready-to-Run Software. Inc. 

All other trademarks are the property of their respective owners. 

< 


Custom Porting Services Also Available _• 

□ Request Reader Service #146 □ 


Windows Developer’s Journal — Page 53 


May 1996 











This works well, because the destructor still gets invoked, but 
the memory doesn't get passed to the global del ete operator. 

Alert VC++ user Mike Woodring noticed a painful flaw in 
this technique, however. If the destructor for the class is 
declared as virtual, VC++ reverts to the old behavior, calling 
the wrapper class. Unfortunately, the compiler neglects to 
push the flag argument before calling the scalar deleting 
destructor. This has two very bad side effects. 

The first problem is that when the scalar deleting destruc¬ 
tor looks at the stack for its copy of the flag argument, it will 
find a random number that was left there by the calling rou¬ 
tine. So it may or may not call the global delete operator after 
calling the destructor. If the flag argument has a bit set in posi¬ 
tion 0, the global del ete operator will be called, which is bad. 

The second problem is that the wrapper function uses a 
Pascal-like calling convention. This means that it removes 
arguments from the stack before returning. In this case, since 
no flag argument was pushed, the stack pointer returned to 
the calling program is now off by four bytes! Once that hap¬ 
pens, it isn't likely that your program will run properly to 
completion. 

An Example 

bug0596. cpp (Listing 1) provides a working demonstration 
of this bug, and manages to document both of the problems it 
creates. 

The first problem occurs when the global del ete operator is 
called for an object that was created using the placement syn¬ 


tax. I detect this by creating my own global delete operator, 
which can then look for a unique value that indicates an error. 

The second problem occurs when the stack is mangled 
after the explicit destructor call. I'm able to demonstrate this 
with the use of a small amount of inline assembly. 

Note that once I detect the mangled stack pointer, I abort 
the program immediately. Removing the call to the C function 
abort!) will result in a return to a random location, which will 
cause a crash, GPF, or if you are really lucky, a complete sys¬ 
tem lockup. 

John Browne of Microsoft indicates that this is indeed a 
bug, and that it has been fixed in Visual C++ v4.0. 

VC++ 4.0 Bug Watch 

For taking the trouble to pin down (thoroughly!) this bug, 
Mike gets our gratitude, as well as a smart WDJ tee-shirt. And 
it's likely that Mike will also be the answer to the trivia ques¬ 
tion: "Who contributed the last Visual C++ 2.x bug to WDJ?" 
Visual C++ 4.0 is quickly becoming the compiler of choice for 
Microsoft users, so in future columns we'll be moving on to 
the current release. We won't, however, tackle bugs in the 16- 
bit compiler that comes with Visual C++ 4.0, because it seems 
unlikely Microsoft will ever fix any bugs in that product. 

As you break in your new copy of VC++ 4.0, be sure to 
keep an eye open for interesting bugs. Send any and all my 
way, and I'll try to fit the best ones in this column. □ 
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Drag-and-Drop Support for 
MFC Listviews 

1 / Ramachandran 



Visual C++ v4.x 
Visual C++ v2.2 


Windows 95 (and Windows NT v3.51) introduced a new "listview" control; you can 
see an example of this control's capabilities in Explorer (see Figure 1). The listview con¬ 
trol lets you display items in a large icon view, a small icon view, a list view, or a report 
view that looks like a columnar listbox except that it includes adjustable-width head¬ 
ers for each column. The first time you program using listviews in your application, 
you expect to be able to drag and drop the items in the listview control in icon and 
small icon mode, since the listviews in Explorer and other Win95 applets behave that 
way. However, the listview control does not, by default, support drag and drop. The 
Win32 SDK does mention some support, but it only provides notifications and func¬ 
tions to help you implement drag-and-drop yourself. The bottom line is that you have 
to code your own support for listview drag-and-drop. 

MFC does not solve the problem either. One would have expected the CLi stCtrl 
class to have encapsulated this behavior, but that is not the case. This article provides 
an MFC class called ZListCtrl that extends CListCtrl to handle drag-and-drop. The 
class declaration for Zli stCtrl is in 1 i stvi ew. h (Listing 1) and the implementation is 
in listview.cpp (Listing2). 

Drag-and-Drop Support in Listviews 

A user initiates a drag-and-drop operation by depressing the primary mouse but¬ 
ton over some visible item in the listview control. At that point, the listview control 
sends a LVN_BEGI NDRAG notification to its parent window, in the form of a WM_N0TIFY 
message. It's up to the parent window to decide what to do with this notification — 
by default, nothing happens. If you want to make the listview provide drag-and- 
drop, you have to do several things when it emits a LVN_BEGI NDRAG notification. 

First, you must create an image that represents the item over which the user 
depressed the mouse button; that image lets the user know that the item is being 
dragged. Second, you must capture the mouse, so that you receive all mouse mes¬ 
sages even if the mouse happens to go outside your window. Finally, you have to 
detect the release of the mouse button and perform the drop operation (assuming the 
mouse was released over a valid target). 


V. Ramachandran is a consultant with Imagine Technologies, Madras, India, where he 
develops Document Imaging and Work Flow solutions. He can be reached at 
raja@imagine. uunet.in. 
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Figure 1 

control 


The four modes of a listview 


list view 


The listview control does provide 
some help with the first task. The 
LVM_CREATEDRAG IMAGE message creates a 
drag image to represent the item to be 
dragged (you can instead use the 
Li stVi ew_CreateDrag!mage( ) macro to 


do the same thing). The listview does 
not, however, help you capture the 
mouse and detect the mouse button 
release. Though initial documentation 
(beta SDK and MSDN articles) men¬ 
tioned an LVN_ENDDRAG notification, no 


such notification appeared in the final 
version of Windows 95. Therefore, you 
must make your own arrangements to 
trap the WM_LBUTTONUP message to end 
the drag-and-drop processing. The 
listview control also does not send any 
notification while the user is dragging 
the item, so you have to handle the 
WM_M0USEM0VE event and provide the 
visual feedback yourself. Fortunately, 
the new Windows 95 image list func¬ 
tions can do most of the work of mak¬ 
ing the drag image appear to move 
with the mouse. 

The ZListCtrl class 

The listview control is encapsulated 
in MFC by the CListCtrl class. 
ZListCtrl inherits from CListCtrl and 
provides drag-and-drop support. The 
programmer can allow or disallow 
drag-and-drop for a particular listview 
control by setting a flag during initial¬ 
ization time. In order to keep the code 
reusable, I call out to virtual functions 
wherever customization is possible. 
This allows other programmers to 
inherit from ZListCtrl and provide 
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Listing 1 listview.h — Declarations forZListCtrl 

/* 

File: ListView.h 

BOOL OnChi1dNotify (UINT message, WPARAM wParam, 

Author: V.Ramachandran 

LPARAM IParam, LRESULT *pLResult) ; 

Date: 23/11/1995. 

void DoBeginDrag (NM.LISTVIEW *pLV); 

ZListView Class with drag-drop support. 

Override the following functions for more control: 

void DoEndDrag (CPoint point, BOOL bMoveltem); 

HandleltemMove - Do the actual move for the item. 

// Overridables to control drag-drop. 

AllowDragOperation - Customize which items can be moved. 

virtual void HandleltemMove (int nDragltem, 

HandleDragMove - Customize the visual feedback while dragging. 

CPoint point); 

*/ 

virtual BOOL AllowDragOperation (WORD wView, 


int nltem); 

#1fndef ZLISTCTRL 

virtual void HandleDragMove (CImageList ‘pDraglmage, 

//define_ZLISTCTRL_ 

POINTS pt); 

//include "afxcmn.h" 

DECLARE MESSAGE MAPO 

DECLARE DYNAMIC (ZListCtrl) 

class ZListCtrl : public CListCtrl 
{ 

protected: 

public: 

BYTE m_bDragDrop; // True if user wants drag-drop. 

ZListCtrl (); 

HIMAGELIST m_hDra g ImageList; // Default dragged imagelist. 

BYTE m_bDragging; // True if user is currently dragging. 

public: 

int m nDragltem; // If user is dragging, this is the item no. 

WORD GetView 0 const 

}; 

{ return (WORD) ( GetStyle 0 & LVS_TYPEMASK); ) 


void EnableDragDrop (BOOL bEnable - TRUE) 

Zfendif // _ZLISTCTRL_ 

{ m_bDragDrop - bEnable; 1 

/* End of File */ 

protected: 


afx_msg void OnLButtonDown (UINT nFlags, CPoint pt); 
afx_msg void OnLButtonUp (UINT nFlags, CPoint pt); 
afxjnsg void OnMouseMove (UINT nFlags, CPoint point); 
afx msg LRESULT OnCustomGetDlgCode (UINT wParam, 


LPARAM IParam); 
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their own behavior. I have designed the class to call out to vir¬ 
tual member functions for three different cases: 

• A11 OwDragOperation() — allows the programmer to specify 
whether to allow dragging or not. 

• Handl eDragMovef) — allows the programmer to specify a dif¬ 
ferent drag image to give visual feedback while dragging. 

• Handl eltemMovet) — allows the programmer to specify how 
exactly the item is to be moved. 


LVN_BEGINDRAG 

As mentioned earlier, listview controls send a LVN_BEGI NDRAG 
notification to the parent window when the user left-clicks on a 
listview item and begins dragging. Like all other common con¬ 
trols, the listview control sends notifications through a 
WM_N0TIFY message. The wParam of the WM_N0TIFY message con¬ 
tains the control ID, while the 1 Pa ram contains a pointer to a 
NMHDR structure, which, among other things, contains the notifi¬ 
cation code. You could handle the LVN_BEGINDRAG in the parent 


Listing 2 listview.cpp — Implementation of ZListCtrl 


/* 

File: ListView.cpp 
Author: V.Ramachandran 
Date: 23/11/1995. 

ZListView Class with drag-drop support. 

*/ 

//include "stdafx.h" // For pre-compiled header support, 
//include ''listview.h" 

IMPLEMENT_DYNAMIC (ZListCtrl, CListCtrl) 

BEGIN_MESSAGE_MAP(ZListCtrl, CListCtrl) 

//{{AFX_MSG_MAP(ZListCtrl) 

0N_WM_LBUTT0ND0WN() 

0N_WM_LBUTT0NUP 0 // For drag-drop. 

0N_WM_M0USEM0VE 0 // For drag-drop. 

0N_ME$SAGE (WMJ3ETDLGC0DE, OnCustomGetDlgCode) 

//))AFX_MSG_MAP 
END_MESSAGE_MAP() 

//define new DEBUG_NEH // For debugging purposes only. 

// Default Constructor. 

ZListCtrl ::ZListCtrl 0 : CListCtrl 0, 

ODragging (FALSE), m_bDragDrop (FALSE) 

( 

) 

/***********************************************************/ 
// OnLButtonDown - MFC handler for WM_LBUTTONDOWN 
// Just set focus to yourself. The listview control does 
// not set focus to itself if the user clicks and drags the 
// left mouse button. 

j***********************************************************j 

void ZListCtrl::OnLButtonDown (UINT nFlags, CPoint pt) 

{ 

SetFocus 0; 

CListCtrl::OnLButtonDown (nFlags, pt): 

} 

/***********************************************************/ 
II OnLButtonUp - Handler for WM_LBUTTONUP 
// Call DoEndDrag to end drag. This the only way to end drag. 
/***********************************************************/ 

void ZListCtrl::OnLButtonUp (UINT nFlags, CPoint point) 

{ 

CListCtrl::OnLButtonUp (nFlags, point); 
if (m_bDragging) 

DoEndDrag (point, TRUE); 

} 

j***********************************************************j 

II OnMouseMove - MFC handler for WM_MOUSEMOVE. 

// Handle visual effects while user is dragging. 
/***********************************************************/ 

void ZListCtrl::OnMouseMove (UINT nFlags, CPoint point) 

{ 

POINT ptScreen; 
if (m_bDragging) { 

ASSERT (m_hDragImageList); 


CImageList ‘pDraglmage - 

CImageList::FromHandle (m_hOragImageList); 

ASSERT (pDraglmage !- NULL); 

// Call out to virtual function to handle move. 

HandleDragMove (pDraglmage, point); 

// Convert to screen coordinates, since DragMove uses the 
// desktop window. 

ptScreen - point; 

ClientToScreen (SptScreen); 
pDragImage->DragMove (ptScreen); 

) 

CListCtrl::OnMouseMove (nFlags, point); 

} 

j***********************************************************j 

II OnChildNotify - protected MFC override. 

// Return TRUE if you have handled message, FALSE to pass 
// onto parent. Handle the LVN_BEGINDRAG notification to 
// begin dragging. 
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Listing 2 continued 


j * ** * ** ** ** ** ** ** ** *** *** *** ** ** ** ** *** ** ** * *** ** ** ** ** ** -kirk j 

// the item or not. Flag is false if the user presses 
// Escape to abort dragging. If the item is to be moved, then 

BOOL ZListCtrl::OnChl1dNotlfy (UINT message, WPARAM wParam, 

// call out to virtual function to handle the actual move. 

LPARAM 1Param, LRESULT *pLResult) 

^*********************************************************** j 

1 

NMHDR *pNotify; 

void ZListCtrl::DoEndDrag (CPoint point, BOOL bMoveltem) 

NM LISTVIEW *pLV; 

{ 

int nView; 

if (mJiDragging) { 

if (message — WM NOTIFY) { 

ASSERT (mJiDraglmageList); 

pNotify - (NMHDR *)IParam; 

CImageList ‘pDraglmage - 

if (pNotify-)code -- LVN_BEGINDRAG) { 

CImageList::FromHandle (mJiDraglmageList); 

nView - GetView 0; 

ASSERT (pDraglmage); 

if (m bOragDrop) { 

ImageList_DragLeave (NULL); 

pLV - (NMJ.ISTVIEW *)IParam; 

pDragImage->EndDrag 0; 

// Call out to virtual function. 

ShowCursor (TRUE); 

if (AllowDragOperation (nView, pLV->iItem)) 

ReleaseCapture 0; 

DoBeginDrag (pLV); 

ImageListJJestroy (mJiDraglmageList); 

) 

mJiDraglmageList - NULL; 

) 

m bDragging - FALSE; 

} 

if (bMoveltem) 

return CListCtrl::OnChildNotify (message, wParam, 

// Call out to virtual function which will handle 

IParam, pLResult); 

// the actual moving. 

) 

HandleltemMove (mjDragltem, point); 

j *********************************************************** J 

} 

// DoBeginDrag - private helper function 


// Parameter: The listview pointer that comes with the 

/***********************************************************/ 

// LVN BEGINDRAG notification. 

// OnCustomGetDlgCode - handler for WM GETDLGCODE. We are 

// CreateDraglmage, get the initial location, the cursor 

// not using MFC's OnGetDlgCode because we need the w and 

// position and then calculate the hotspot position. Hide 

// IParams. For more information, read the note on the MSDN 

// cursor and capture mouse. 

// CD-ROM PSS No. Q83302. 

/*********************************************************** j 

// This just handles the escape key while you are dragging. 

j****+**************★*★*************************************j 

void ZListCtrl::DoBeginDrag (NM LISTVIEW *pLV) 


( 

LRESULT ZListCtrl ;: OnCustomGetDlgCode (UINT wParam, 

ASSERT (pLV) ; 

LPARAM IParam) 

POINT ptCurrent; 

( 

mjDragltem - pLV->i Item; 

LRESULT 1 Result - Default 0; 
if ((m bDragging) M (IParam)) { 

m hOraglmageList - (HIMAGELIST)SendMessage ( 

LPMSG lpMsg - (LPMSG)lParam; 

LVM_CREATEDRAGIMAGE, mjDragltem, 

if (OpMsg->message — WM KEYDOWN) M 

(LPARAMJ&ptCurrent); 

(lpMsg->wParam -- VK_ESCAPE)) { 

if (m_hDragImageList — NULL) // Error! Should never happen. 

POINT pt; // Not used logically. 

return; 

DoEndDrag (pt, FALSE); 

CImageList ‘pDraglmage - 

1 Result |- DLGC WANTMESSAGE; 

} 

CImageList :: FromHandle (mJiDraglmageList); 

ASSERT (pDraglmage) ; 

} 

return IResult; 

// Get the click position. We use GetMessagePos since 

} 

// LVN BEGINDRAG notification does not give us this info. 


DWORD dwPos - GetMessagePos 0; 

// Default overrideables. 

POINT ptClickClient, ptClickScreen ; 

j *********************************************************** j 

ptClickScreen.x - LOWORD (dwPos); 

// AllowDragOperation - virtual function. Override to 

ptClickScreen.y - HIWORD (dwPos); 

// control whether an item can be moved or not. 

ptClickClient * ptClickScreen; 

// Current implementation allows dragging for icon and 

ScreenToCTient (SptClickClient); 

// small icon views. 

// Parameters: Current view and item to move. 

// Get the cursor hotspot position with respect to 

// Return TRUE to allow drag, FALSE to disallow. 

// the top-left of the drag image. 

j *********************************************************** j 

POINT ptHotSpot; 


ptHotSpot.x - ptClickClient.x - ptCurrent. x; 

BOOL ZListCtrl : :AllowDragOperation (WORD wView, int nltem) 

ptHotSpot.y - ptClickClient.y - ptCurrent.y; 

{ 

if ((wView -- LVS ICON) || (wView -- LVS SMALLICON)) 

if (pDragImage->BeginDrag (0, ptHotSpot)) { 

return TRUE; 

// DragEnter uses the desktop window, so that the cursor 

else 

// gets displayed even if the user moves the cursor out 

return FALSE; 

// of the listview. 

} 

ImageList_DragEnter (NULL, ptClickScreen.x, 


ptClickScreen.y); 

/*********************************************************** j 

ShowCursor (FALSE); 

1/ HandleDragMove - overrideable virtual function. 

SetCapture 0; 

// Parameters: CImageList pointer. This is initially set 

m bDragging - TRUE; 

// to the default listview image, pt indicates the client 

) 

// position of the mouse. 

} 

// The default version does nothing. 

// Set the image!ist pointer to what you want displayed and 

^***********************************************************y 

II the point at which it is to be displayed. 

// DoEndDrag - private helper function 

!*********************************************************** j 

// Ends the drag operation. Called from WM LBUTTONUP handler. 


// Parameter: Point to move to, flag indicating whether to move 

void ZListCtrl::HandleDragMove (CImageList ‘pDraglmage, 
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window, but I really want to keep all the drag-and-drop func¬ 
tionality hidden inside the ZLi stCtrl code, rather than require 
effort on the part of the window enclosing it. Fortunately, 
MFC makes this a straightforward task. 

MFC's CWnd class reflects child notification messages 
back to the corresponding MFC object that sent them, giving 
the MFC object a chance to handle the notification first. So, 
when the listview control sends its WM_N0TI FY message to its 
parent window (typically an instance of a CDialog or 
CFormView derived class), the parent window calls the 
listview's virtual function OrtChildNotifyO. (In our case, 
ZLi stCtrl:: OnChi 1 dNoti fy will be called.) It can then pass on 
the message to the parent, or discard the notification. In order 
to handle the LVN_BEGI NDRAG notification, I override 
OnChildNotify( ) in ZLi stCtrl and process the LVN_BEGI NDRAG 
notification, like this: 

BOOL ZListCtrl::OnChi1dNotify ( 

UINT msg, WPARAM wParam, 

LPARAM 1Param, LRESULT *pLResult) 

{ 

NMHDR *pNotify; 
if (msg == WMJOTIFY) { 

pNotify = (NMHDR *)1Param; 
switch (pNotify->code) { 
case LVN_BEGINDRAG: 

... initiate drag-and-drop. 

} 

) 

return CListCtrl::OnChi1dNotify (msg, 
wParam, 1 Pa ram, pLResult); 

} 


The LVN_BEGI NDRAG handler first checks whether drag-and- 
drop support for this control is enabled. If it is, the handler 
calls out to a virtual function, 
ZListCtrl::AllowDragOperation(). If AllowDragOperationt) 
returns TRUE, the drag operation begins. The 
ZListCtrl: :AllowDragOperation( ) returns TRUE if the listview 
is in the icon or small icon view. If dragging is to be allowed, 
the code then calls the member function DoBeginDragO. 

DoBegi nDrag () sends a LVM_CREATEDRAG I MAGE message to the 
control, which returns a handle to the image list (HIMAGELIST) 


Listing 2 continued 


{ 

return; 

1 


POINTS pt) 


j***********************************************************j 

II HandleltemMove - virtual function. Override to do the 
// actual move of the item. 

// Current implementation moves the item for icon and 
// small icon views. 

// Parameters; Dragged item, point at which item was 
// dropped (client coordinates). 

/*********************************************************** j 

void ZListCtrl::HandleltemMove (int nDragltem, CPoint point) 

( 

WORD wView - Getl/iew 0; 

if ((wView -- LVSJCON) || (wView — LVSJMALLICON)) 
SetltemPosition (mjDragltem, point); 

} 


//End of File 



that contains the drag image. This image is used to display 
visual feedback to the user during the drag-and-drop opera¬ 
tion. I store this handle in a member variable named 
m_hDrag Image Li st. To display the image list on the screen, I use 
the Windows 95 image list functions, ImageLi st_Begi nDrag() 
and ImageList_DragEnter( ). Finally, DoBeginDragO calls 
SetCaptureO to capture the mouse, ensuring that all mouse 
moves will come to the listview control, even if the mouse 
moves outside of its window boundaries. 
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Handling Subsequent Mouse Moves 

The ZListCtrl WM_M0USEM0VE handler uses a variable 
(m_bD ra gg i ng) to check whether the user is currently dragging 
an item. If so, the handler provides visual feedback to the user 
by displaying the dragged image. By overriding the 
HandleDragMoveO message, the programmer can supply the 
image to display while the user is dragging. By default, a 
dithered image of the dragged image is displayed. Again, the 
image list function ImageList_DragMove( ) is used to display 
the image on the screen. 

End Drag 

There is no notification to indicate that the drag operation 
has ended. Therefore, in the WM_LBUTTONUP notification handler, 
I check whether the user was in the drag mode (m_bOraggi ng is 
TRU E), and if so, I know that the drag operation has ended. The 
OnLBlittonUp () handler calls out to a virtual function, 
Handl eltemMovef ), to do the actual moving of the item. 
ZListCtrl: :HandleItemMove( ) calls the listview function 
Set I temPos i ti on () to move the item to the new position. Note 
that SetltemPosition( ) works only in the icon and small icon 
modes. To make this work with the other modes, you would 
have to translate the position to a particular listview entry and 
call the appropriate functions to move the item being dragged 
up or down. 

Handling the Escape Key 

The Escape key is a special key and the Windows dialog 
manager handles it by sending a WM_COMMAND message to the 
dialog box with wParam equal to IDCANCEL. In the middle of a 
drag operation, the Escape key has to be handled by the 
listview control and should not be seen by the dialog manag¬ 
er. You accomplish this by processing the WM_GETDLGCODE mes¬ 
sage. In MFC, you typically use OnGetDI gCode () as the handler 
for WM_GETDLGCODE messages. But OnGetDI gCode () does not give 
you the wParam and 1 Pa ram that come with the message. Since I 
need the 1 Param, I have a custom handler for WM_GETDLGCODE — 
I use the ON_MESSAGE macro instead of ON_WM_GETDLGCODE in the 
message map. 

An undocumented feature of WM_GETDLGCODE is that if 
1 Param is not NULL, it points to a MSG structure that contains the 
message being sent to the control. Windows versions 3.0 and 
3.1 use 1 Param only to send keyboard input to the control. 
Keyboard messages include WM_KEYDOWN, WM_SYSCHAR, and 
WM_CHAR (this is explained in the MSDN Knowledge Base arti¬ 
cle PSS No. Q83302). Therefore, in the WM_GETDLGCODE handler, 
the code detects the arrival of a WM_KEYDOWN message with a key 
of VK_ESCAPE. In that case, the code aborts the dragging and 
returns the original value returned by the default WM_GETDL- 
GCODE handler ORed with DLGCJANTMESSAGE. DLGCJANTMESSAGE 
tells Windows that the control wants the WM_KEYDOWN message, 
and therefore the dialog manager does not see this message. 

The Sample Application 

The code disk contains a sample application (see Figure 2) 
that demonstrates the drag-and-drop features of ZListCtrl. 
You can right-click to toggle between the various views, and 
drag-and-drop using the left mouse button. You will notice 
that the drag-and-drop works only in the icon and small icon 
views, since this is the default Z Li stCtrl functionality. 


To create the sample application, I used AppStudio to add 
a listview control, and associated a ZLi StCtrl object with it. In 
OnlnitDialogO I first enable drag-and-drop for the listview 
control by calling ZListCtrl: :EnableDragDrop(). I then create 
and assign the icon and small icon image lists to the listview. 
The next step is to add a single column for the report view, 
after which the items are added. Since adding an item to the 
listview involves a few lines of code, I encapsulated the func¬ 
tionality in the CGeneri cDl g : : Add I temToLi s tVi ew () function. I 
also handle the NM_RCLICK notification from the listview con¬ 
trol and switch views. This way the user can right-click to 
switch views and see the drag-and-drop behavior for the dif¬ 
ferent views. 

Extending ZListCtrl 

By inheriting from ZListCtrl and overriding the virtual 
functions, you can control the listview behavior to a large 
extent. Below, I list the virtual functions and how you might 
take advantage of them. 

BOOL AllowDragOperation( 

WORD wView, int nltem) 

All owDragOperati on ( ) is called whenever the user begins 
dragging. By overriding this function, you can decide which 
views support drag-and-drop. You can also decide which 
items can be moved, by selectively returning TRUE or FALSE for 
individual items. 

void HandleDragMove( 

CImageList *pDragImage, P0INT& pt) 

HandleDragMoveO is called whenever the user is dragging the 
item (WM_M0USEM0VE messages). The dithered image of the 
dragged item is supplied by default, and pt contains the client 
coordinates of the mouse. If you don't want the user to drop 
the item over certain areas, you can set pDraglmage to a "No- 
Dropping-Zone" image. 

void HandleltemMove( 

int nDragltem, CPoint point) 

HandleltemMovet ) is called when the user has finished drag¬ 
ging. For icon and small icon views, this calls 
S e 111 e m P o s i t i o n () . For other views, you will have to simulate 
the move, by deleting the item from the original position and 
adding it in the position specified by point. If you don't want 
the user to drop the item over certain areas, you can beep and 
do nothing. You would also do application-specific things in 
this override. 

Conclusion 

By using the ZLi StCtrl class, you avoid having to code the 
basic drag-and-drop functionality users expect. This class pro¬ 
vides only the most basic capability, but it can be extended to 
support right-mouse drag-and-drop functionality as well. 
Other than this, the ZLi StCtrl class could contain helper func¬ 
tions to add/insert/delete items in the listview control. Other 
listbox functions (like GetCurSel (), SetCurSelO, 
GetSel I terns (), FindStringO, etc.) could also be built into 
ZListCtrl. □ 
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Synchronizing Speed Buttons 
and Menu Items with Tags 

George Tylutki 


Most Delphi components have a Tag field which can be used to store information 
relevant to the component. Any longint value can be assigned to tags, which are 
especially useful for synchronizing speed buttons and menu items. Although not 
every menu item has a corresponding speed button, every speed button should have 
a corresponding menu item; after all, they're meant to be shortcuts. Often, when a 
speed button is clicked, one menu item must be checked and another unchecked. 
And when a menu item is clicked, one speed button must depressed and another 
raised. Further, each speed button and its corresponding menu item must initiate the 
same action. The Tags program, in main.pas (Listing 1), demonstrates how to syn¬ 
chronize these activities. When an item from the tools menu or a speed button is 
clicked, the cursor for Mainlmage changes; when the mouse cursor is moved over 
Mai n Image, it will assume a shape appropriate to the currently selected tool. 

There are six menu items under the Tools menu and six corresponding speed but¬ 
tons. Each represents a tool that might be used in a simple drawing program — draw 
a line, a circle, etc. Determining which menu item or speed button was clicked and 
what action to take is done in TMainForm.ChooseTool, which the six menu items and 
speed buttons share as their OnCl i ck method (through a process Borland calls dele¬ 
gation). 

Arriving at an Optimal Method 

A case statement can't be used to determine which component the user clicked 
(case Sender of) because Sender is not an ordinal type (i nteger, 1 ongi nt, word, etc.). 
It could be done in a series of i f statements: 

if (Sender is smToolsLine) 
or (Sender is SBtnLine) then 

ToolSelected := tsLine 
else if (Sender is smToolsRect) 
or (Sender is SBtnRect) then 

ToolSelected tsRect 
else ... 

case ToolSelected of 
ts Line : DrawLine; 
tsRect : DrawRect; 

end; 

but this becomes unwieldy in a program with many speed buttons. Moreover, check¬ 
ing menu items and depressing speed buttons still have to be taken care of. 

By giving each menu item and its corresponding speed button the same, unique 
tag value, you can determine which the user clicked by checking the Tag property. 


George Tylutki holds a Ph.D. in English and is a partner in 100% Cotton Software (RR1, 
Box 1622, Hop Bottom, PA 18824), which publishes NFL Forecaster, Have You Read 
That Movie?, and other programs. 
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Listing 1 main.pas — Program to demonstrate Delphi tags 


unit Main; 
interface 
uses 

WinProcs, Classes. Controls, Forms. Menus. 
Buttons, ExtCtrls, StdCtrls, SysUti1s; 

type 

TMainForm - class(TForm) 

MainMenu: TMainMenu; 
mmFile: TMenuItem; 

smFileExit: TMenuItem: 
mmTools: TMenuItem; 
smToolsNone: TMenuItem; 
smToolsLine: TMenuItem; 
smToolsRect: TMenuItem; 
smToolsCircle: TMenuItem; 
smToolsFilledRect: TMenuItem; 
smToolsFi11edCircle: TMenuItem; 

ToolBarPanel: TPanel; 

SBtnNone: TSpeedButton; 

SBtnLine: TSpeedButton; 

SBtnRect: TSpeedButton; 

SBtnCircle: TSpeedButton; 

SBtnFi11edRect: TSpeedButton; 

SBtnFi11edCircle: TSpeedButton; 

Mainlmage: TImage; 

PtrLabel: TLabel; 

procedure FormCreate(Sender: TObject); 
procedure smFi1eExitClick(Sender: TObject); 
procedure ChooseTool(Sender; TObject); 
procedure StopDrawing; 
procedure Drawline; 
procedure DrawRect(Filied : boolean); 
procedure DrawCircle(Filled : boolean); 


var 

MainForm: TMainForm; 
implementation 


const 

tsNone - 249; {menu item and speed button tags} 

tsLine - 250; 

tsRect - 251; 

tsCircle - 252; 

tsFi11edRect - 253; 

tsFilledCircle - 254; 

ToolSelected : integer - tsNone; {default} 

crDrawline - 1; {cursors} 

crRect - 2; 

crFRect - 3; 

crCircle - 4; 

crFCircle - 5; 

{$R *.DFM} 

{$R TAGS2.RES} {cursors in this res file} 

procedure TMainForm.FormCreate(Sender: TObject); 
const 

CursorNames : arrayfcrDrawLine..crFCircle] of pChar 
CcrLine', 'crRect'. 'crFRect'. 'crCircle', 
'crFCircle'); 
var 

x : integer; 
begin 

for x crDrawLine to crFCircle do 
Screen.Cursors[x] LoadCursor(hlnstance. 

CursorNames[x]); 

end; 


procedure TMainForm.smFi1eExitClick(Sender: TObject); 
begin 
Close; 
end; 


procedure TMainForm.ChooseTool(Sender: TObject); 
var 

x : integer; 

OldTool : integer; 


begin 

OldTool ToolSelected; 

ToolSelected (Sender as tComponent).Tag; 

if OldTool <> ToolSelected then 

begin 

for x 0 to ComponentCount -1 do 

if ComponentsCx] is tMenuItem then 
begin {as long as all component tags < 255} 
{can use IN} 

if (tMenuItem(Components[x]).Tag in [OldTool, 
ToolSelected])then 
tMenuItem(Components[x]).Checked 
not tMenuItem(ComponentsCx]).Checked; 
end 
else 

if ComponentsCx] is tSpeedButton then 
begin {old button will pop up automatically} 
if (tSpeedButton(ComponentsCx]).Tag - 
ToolSelected) then 

tSpeedButton(Components[x]).Down true; 
end; 

case ToolSelected of 
tsNone : StopDrawing; 
tsLine : DrawLine; 
tsRect : DrawRect(false); 
tsFi11edRect : DrawRect(true); 
tsCircle : DrawCircle(false); 
tsFilledCircle : DrawCircle(true); 

end; 

PtrLabel.Tag 1ongint(@ToolSelected); 

PtrLabel.Caption 

IntToStr(integer(pointer(PtrLabel.Tag) A )); 

end; 

end; 


procedure TMainForm.StopDrawing; 
begin 

Mainlmage.Cursor crDefault; 

{do whatever is necessary to stop drawing} 
end; 


The #1 Internet debugging tool does Win32! 


TracePlus debugging tools for Windows 3.1/ 
95 /NT effortlessly display the interaction 
between your Windows application and 

Winsock, VBX controls, ODBC. DB-Library, 
or the Win31 API. 
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TracePlus provides critical realtime information 
for developers and technical support people to 
resolve complex software bugs quickly. 

TracePlus/Winsock has been featured in at 
least two books on Winsock Programming, and 
the demo appears on 10 Internet CD-Roms. 

Tough customers such as Microsoft, Novell, 
Lotus, IBM, Siemens, Unisys, A.T.&.T., and 
FTP Software use the best tools they can get. 


5727 Canoga Ave., #238 
Woodland Hills, CA 91367 

Sales: (800) 200-5878 
Office: (818) 346-4584 
Fax: (818) 346-7070 

Internet: sstinc@netcom.com 
CompuServe: 70233.2504 
America Online: Ssstinc 


They chose TracePlus. You can too. Download yj s jt our Worldwide Web site at 1 
our free demo software from our Web page! http://www.webcom.com/~sstinc 


“TracePlus has been a godsend when trying to debug 
customers problems”. G.N., Dart Communications 



Trace+A/BX: $99.95 
Trace+/Winsock: $99.95 
Trace+32/Winsock: $139.95 
Trace+/ODBC: $109.95 
Trace+/Windows: $99.95 
Trace+/SQLServer: $109.95 


Check out TracePlus 
/Winsock for Win32 and 
TracePlus/VBX for Win31! 
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The Tags program declares a series of 
constants for each tool (tsLine, tsRect, 
etc.) and assigns the same constant to 
both the menu item and its correspond¬ 
ing speed button. For example, the Tag 
values of the menu item smToolsCircle 
and the speed button SBtnCircle are 
both set to 252 (tsCi rcl e). Determining 
which menu item or speed button was 
clicked is simplified by typecasting 
Sender in order to access the Tag proper¬ 
ty: 

if Sender is TMenuItem then 
ToolSelected (Sender as TMenuItem).Tag 
else/ 

ToolSelected (Sender as TSpeedButton).Tag; 
case ToolSelected of 

end; 

Since TMenuItem and TSpeedButton both 
descend from the same ancestor, 
TComponent, this can be simplified to: 

ToolSelected (Sender as TComponent).Tag; 
case ToolSelected of 

end; 

This is much better than the original 
series of i f statements, but there is still 
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the problem of checking menu items and depressing speed 
buttons. Using Tool Selected (a typed constant which is really 
an initialized variable), you can determine which menu items 
and speed buttons need to be manipulated: 

case ToolSelected of {old tool) 
tsLine : {uncheck smToolsLine and raise SpeedBtnLine}; 
tsRect : {uncheck smToolRect and raise SpeedBtnRect}; 

end; 

ToolSelected := (Sender as TComponent).Tag; 
case ToolSelected of {new tool) 
tsLine : {check smToolsLine and depress SpeedBtnLine}; 
tsRect : {check smToolRect and depress SpeedBtnRect}; 

end; 


This works, but maintaining multiple (long) case statements 
can be difficult. Every time you add or delete a menu item or 
speed button, the case statements have to be revised. Every 
Delphi component (including TForm) has a Components proper¬ 
ty, which is a list of the components owned by the component. 
Within a loop you can iterate through the Components list look¬ 
ing for a specific component. 

for x := 0 to ComponentCount-1 do 
if Components[x] is TMenuItem then 
begin 

if (TMenuItem(Components[x].Tag = OldTool) 
or (TMenuItem(Components[x].Tag = ToolSelected) then 
tMenuItem(Components[x].Checked 
:= not tMenuItemfComponents[x].Checked; 
end 
else 


Listing 1 continued 


procedure TMainForm.DrawLine; 
begin 

Mainlmage.Cursor crDrawLine; 
{draw a line) 
end; 


procedure TMainForm.DrawRect(Fi11ed : boolean): 
begin 

if Filled then 
begin 

Mainlmage.Cursor crFRect; 

{draw filled rectangle) 
end 
else 
begin 

Mainlmage.Cursor crRect; 

{draw empty rectangle) 
end; 
end; 


procedure TMainForm.DrawCircle(Fi11ed : boolean); 
begin 

if Filled then 
begin 

Mainlmage.Cursor crFCircle; 

{draw filled circle) 
end 
else 
begin 

Mainlmage.Cursor crCircle; 

{draw empty circle) 
end; 
end; 

end. 

{ End of File ) 


more than just a Database Browser 



Edit[T]able 

The purpose of Edit[T]able is to provide a table structure on screen as an 
interface between an end user, browsing or typing in data, and the application 
managing the data. Edit[T]able DLL is database independent. 

The transfer between the end user and the DLL is supported by WINDOWS'", 
the transfer between the DLL and the application is done via classes and calls 
to their virtual functions, i.e. the functions are coded in the application, but 
called from the Edit[T]able DLL. 

In C applications, the virtual functions are replaced by function pointers. 
Supported field types: 

String Integer Long Float Double Date Time 

The layout and the attributes of the table structure and the fields are to be 
defined with a separate design tool(included), so that you can change these 
attributes without re-compiling the application. 

A free demo disk with examples for linked list, array structure and PAFRADOX® 
Engine is available. 

Soimsslr 23 Ut^7 „„„ 8 ♦49 30 692 44 95 

10961 Berlin Fax 30 892 35 55 

Germany /^^£*** & HCoropu«erve ID: 100325,1266 
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MFC extension class library implements embeddable 
dialog editor / GUI builder. HyperView++ combines 
the power of Visual C++ with the ease of Visual Basic! 

♦ Embed a custom view / dialog editor into your application 

♦ Build your GUI visually at run time without recompilation 

♦ Dynamically generate forms from database on the fly 

O Define your data. Define your GUI objects and controls. 
Connect them together at run time with unlimited flexibility! 



HYPERCUBE 4 demo: 

ISi'aSj (800) 268-1812 • harlan@hcube.com ‘ 
http://www.hcube.com/hvwpage.html 

10542 Bradbury Rd. Los Angeles, CA 90064 • (310) 559-2354 
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However, if the values you assign to the tags fall in the range 1 
to 255, you can use the IN operator to determine whether a 
component's tag is in a set (such as [OldTool, Tool Selected]) 
instead of testing for equality twice in an i f statement. (A set 
can contain values from 0 to 255, but 0 is the default value of a 
component's tag.) In the procedure ChooseTool, the list of com¬ 
ponents owned by Main Form is searched. If a component is a 
menu item or a speed button, a check is made to determine if 
its Tag property corresponds to the OldTool or Tool Selected 
value. If so, the Checked or Down properties are set to the appro¬ 
priate values. 

for x 0 to ComponentCount -1 do 

if Components[x] is tMenuItem then 
begin {as long as all component tags < 255 can use IN) 
if (tMenuItem(Components[x]).Tag 
in [OldTool, ToolSelected])then 
tMenuItem(Components[x]).Checked 

not tMenuItem(Components[x]).Checked; 

Constants are used rather than an enumerated type such as 
Tool Sel ected = [tsNone, tsLine, etc.], because enumerat¬ 
ed types are zero-based and zero is the default value for 
components' tags. The first would have to be a never-used, 
dummy value and care would have to be taken not to use val¬ 
ues 1 to 6 again. 
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Other Issues 

The speed buttons in the Tags program are mutually exclu¬ 
sive. Clicking a button which isn't depressed forces it to the 
down position and forces the currently depressed button to 
the up position. This results from setting the Group property of 
each speed button to the same non-zero number. Therefore, in 
the ChooseTool procedure it really isn't necessary to set a speed 
button's Down property to T rue or False when it is clicked; that 
happens automatically. But it is necessary to do so if a menu 
item is clicked. However, resetting the Down property to its cur¬ 
rent value causes no problems. 

The cursors used in the Tags program were created using 
Delphi's Image Editor and saved to the file tags2. res. The line 
{$R TAGS2.RES] at the start of the i mplementation section caus¬ 
es the resources in tags2.res to be compiled into tags.exe. 
Don't attempt to directly modify the default . res file that has 
the same name as the program (for example, tags. res); Delphi 
maintains this file. Always create additional. res files for your 
resources. Screen, a predeclared variable of type tScreen, has a 
Cursors property that maintains a list of cursors available to 
your program. There are constants for the standard cursors 
(crDefaul t, crCross, etc.). Add cursors to the list by declaring a 
constant for each and calling the Windows function 
LoadCursorC ). You should not call DestroyCursort ) when you 
are finished (at program's end) with the cursors you have 
added to Screen.Cursors; they are destroyed automatically. 
You do have to call DestroyCursor( ) if you maintain your own 
list of cursors. 

The last two lines of TMa i nForm. ChooseTool illustrate one 
method of saving a pointer in a Tag property. The address of 
(@) Tool Sel ected is typecast to a longint and assigned to 
PtrLabel .Tag. Then the value is immediately displayed in 
Ptr Label: the value is typecast to a pointer, dereferenced, 
typecast to an i nteger, and converted to a stri ng by the func¬ 
tion IntToStr from the SysUti 1 S unit. There is no good reason 
for assigning a tag value and immediately retrieving it, as 
done in these two lines, except to illustrate one way of storing 
and accessing pointers in a Tag property. 

Summary 

An advantage of the method of manipulating the Tag prop¬ 
erty illustrated in ChooseTool is that it works even if you add 
or remove menu items or speed buttons; no changes have to 
be made to the short loop. You do have to be sure that you 
assign unique, non-zero values to the Tag properties of the 
appropriate menu items and speed buttons. □ 
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Hard-to-find titles and titles you won’t find anywhere else 
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Writing Windows VxDS and Device 
Drivers 

By Karen Hazzah 

Karen Hazzah explains the full range of 
alternatives for interfacing Windows 
applications to hardware, from the 
simplest DLL (Dynamic Link Library) or 
TSR to complex VxDS (Virtual Device 
Drivers). Karen shows how to write a 
VxD without burying the reader in 
Windows trivia and API references. This 
book is not for the beginner. These 
techniques require knowing assembly 
language, C, and DOS, especially direct 
calls to DOS using interrupt INT21. 

R&D Publications, 1995, 350 pp. 

ISBN 0-13-100181-7 


T59C with disk.$49.95 


WILLIAM SMITH 
ROBERT WARD 



WINDOWS 

CUSTOM 

CONTROLS 


Windows Custom Controls 

By William Smith & Robert Ward 

This book demonstrates how to make 
powerful and usable custom controls for 
Microsoft Widows. The openness of the 
Windows programming environment 
allows the developer a wide range of 
options. Smith & Ward show how to 
exploit this creative opportunity with a 
modular technique that brings structure 
and reusability to Windows application 
designs. Reusing the custom controls 
allows you to focus on the larger design 
issues. 

R&D Publications, 1993, 531 pp. 
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W99S with disk.$55 



system programming 

2S Pearls for DOS Prosrammor* 


edited by 

David Burki 
Robert Ward 



MS-DOS System Programming: 

Third edition 

Edited by David Burki & Robert Ward 

Veterans and beginners will all find 
something in this collection to save time 
and program MS-DOS more efficiently. 
Some of the updated chapters include 
critical error handling, modifying the DOS 
boot, interrupt-driven serial I/O, TSRs, 
accessing the global environment, and 
interfacing to the floppy disk controller. 
New chapters include serial 
communications, the floating point 
coprocessor, CD-ROM drivers, Direct 
Memory Access, and the PC speaker. 
Each chapter gives complete details and 
can be read independently. The 
companion disk includes all the code. 

R&D Publications, 1994, 811 pp. 

ISBN 0-13-207382-X 
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By Guy Eddon 

RPC for NT shows how to harness the 
power of distributed computing on a PC 
network with a Windows NT server. Guy 
Eddon provides a step-by-step guide to 
developing Remote Procedure Calls. He 
explains standards and requirements, 
how RPC is related to other parts of 
Windows, and how to use RPC with 
parallel processors, multiprocessors, and 
transputers. Use RPC to solve problems 
in a fraction of the time it would take a 
single machine. 

R&D Publications, 1994, 427 pp. 
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Industry-Related News & Announcements 


Send your press release 
to Miller Freeman, Inc. 
1601 W. 23rd St. 
Suite 200 
Lawrence, KS 66046 


Graphical Designer Handles Custom Design Methods 


Graphical Designer is a software design and reengi¬ 
neering tool that supports OO design methods such as 
Rumbaugh OMT, Booch, and C Structure Graph. 
Programmers can generate C and C++ code directly from 
their software designs or reverse-engineer existing C/C++ 
applications with the product's automatic design genera¬ 
tion capability. This version also supports the reuse of soft¬ 
ware components; individual components can be saved as 


building blocks for use in other applications. 

Graphical Designer vl.2 costs for UNIX-based worksta¬ 
tions start at $4,999; the company plans Windows 95 and 
Windows NT versions later this year. For more informa¬ 
tion, contact Advanced Software Technologies, Inc., 7800 
South Elati Street, Suite 205, Littleton, CO 80120-4456, 

(303) 730-7981; fax (303) 730-7983; info@advancedsw.com. 


fax 913-841-2624 


wdletter@rdpub. com 


Nombas Ships Macro Language, Interpreter 


Cmm is a C-like programming language that fits in 
64Kb, supporting all standard C functions and operators, 
but handling memory management internally. Users can 
write scripts in Cmm that run unchanged on DOS, 
Windows 3.1, Windows NT, Windows 95, OS/2, UNIX, 
and the Macintosh. The Cmm Macro Language Toolkit lets 
you incorporate Cmm scripts into third-party applications. 


PowerScript Automates Builds 

PowerScript is a programming language you can use to 
automate Windows tasks; it allows you to write scripts that 
run applications, find existing windows, perform menu 
selections, fill in dialog boxes or edit controls, click buttons 
or listboxes, simulate keyboard input, and wait for opera¬ 
tions to finish. Sample scripts included with the package 


and includes the Cmm library, 150 functions, and two sam¬ 
ple implementations. 

The Cmm Macro Language Toolkit costs $5000, or $499 
for an evaluation developer's kit. The CEnvi Cmm 
Interpreter costs $69 per single-user license. For more 
information, contact Nombas, Inc., 64 Salem Street, 
Medford, MA 02155, (617) 391-6595; fax (617) 391-3842; 
nombas@nombas.com. 


automate multi-component builds in Visual C++ or 
Borland C++. 

PowerScript costs $79.90. For more information, contact 
Desiderata Software, 675 VFW Parkway, #301, Chestnut 
Hill, MA 02167, (800) 888-7754; desisoft@gnn.com; 
http://wwwl.usal.com/~desisoft; or 
http:members.gnn.com/desisoftl. 
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BetterState Pro Offers Diagramming, Code Generation 


Statecharts are state diagrams augmented to support 
state machine hierarchy, concurrency, visual priorities, 
decision polygons, critical regions, and other diagrammatic 
design capabilities. BetterState Pro is a statechart design 
entry tool that combines code generation with visual 
debugging capabilities such as animated playback and 
interactive state animation. The company is now offering 
code generators for Delphi and MFC, in addition to previ¬ 


ous code generators for C++, Visual Basic, Verilog HDL, 
VHDL, C, and Dynamic C. 

BetterStatePro costs range from $299 (for BetterState 
Lite) to $995 (for BetterState Pro with all code generators). 
For more information, contact R-Active Concepts, Inc., 
20654 Gardenside Circle, Cupertino, CA 95014, (408) 252- 
2808; fax (408) 438-7684; http:llivwiv.ractive.com/ractive. 


Micro Focus Ships VBX, ODBC Driver, 32-Bit COBOL WorkBench 


Micro Focus is now offering Correlate vl.O, a tool that 
lets ODBC applications access Micro Focus COBOL data 
files. It consists of a developer component (a GUI tool for 
mapping COBOL records to SQL tables), an administrator 
component (for specifying the location of the data dictio¬ 
nary and COBOL data files on the end user's station), and 
an execution component (an ODBC driver). 

Micro Focus is shipping a new VBX interface to their 
Application-to-Application Interface for Windows 
(AAI/Win). AAI lets applications communicate with other 
AAI applications on the same machine or other networked 
machines using a 2-tier, 3-tier, or »-tier client/server archi¬ 
tecture. The new VBX interface gives Visual Basic and 
PowerBuilder developers access to AAI features. 


Micro Focus COBOL Workbench v4.0 is the latest ver¬ 
sion of the company's integrated development suite for 
Windows, Windows NT, Windows 95, and OS/2. This ver¬ 
sion features a 32-bit environment that handles applica¬ 
tions that previously would have been too large. The pack¬ 
age includes an integrated source code management facili¬ 
ty 

Correlate costs $500. AAI/Win VBX Interface is free to 
licensees who have a maintenance agreement for 
AAI/Win. Micro Focus COBOL Workbench v4.0 costs 
$2,500; Micro Focus Object COBOL v4.0 costs $1,250; Micro 
Focus CICS Option v4.0 costs $1,250; Micro Focus 
Transaction System v4.0 starts at $8,000 for 16 users. OSX 
Server is $500 per copy. For more information, contact 
Micro Focus, 2465 East Bayshore Road, Palo Alto, CA 
94303, (415) 856-4161; fax (415) 856-6134. 


HOPE Offers Team Development for C++!java 


Aladdin Software Engineering Ltd has released HOPE, 
the Human Oriented Programming Environment for team 
development in C/C++ and Java. HOPE stores each "parti¬ 
cle" of code (function, class, method, etc.) as a unique 
object in a database, providing information sharing, lock¬ 
ing of fine-grained objects, process-oriented source code 
management, smart merge tools, and real-time change 
management. Any number of programmers can work con¬ 
currently on the same code, handling merges at the "parti¬ 


Student C++for $45, Fortran for $75 

Salford Software Ltd has announced low cost student 
editions of its Fortran and C/C++ compiler for the PC. 
FTN77 is a full 32-bit implementation of the Fortran 77 
standard, and is available under DOS, Windows 3.1, 
Windows 95, and Windows NT. SCC is a 32-bit ANSI C 
and C++ compiler. FTN90 is a 32-bit compiler that imple¬ 
ments the Fortran 90 language standard. All the compilers 
come with user guides, libraries, and development tools, 
and are available for DOS (extended DOS for FTN90), 


cle" level rather than file by file. The product runs under 
Windows 3.x, Windows NT, and Windows 95, and a UNIX 
version is under development. 

HOPE costs $995 per seat. Until July 31, a three-user 
license costs $295 and includes an upgrade to the next ver¬ 
sion. For more information, contact Aladdin Software 
Engineering Ltd., The Empire State Building, 350 Fifth 
Avenue, Suite 6614, New York, NY 10118, (800) 223-4277 or 
(212) 564-5678; fax (212) 564-3377; http:llzvwzv.aks.com. 


Windows 3.1, Windows 95, and Windows NT. The compil¬ 
ers each include Salford's ClearWin+ library for simplify¬ 
ing the process of implementing a user interface under 
Windows. 

The Student Edition of FTN77 costs $75, FTN90 costs 
$99, and SCC costs $45. For more information, contact 
Salford Software, Adelphi House, Adelphi Street, Salford, 
M3 6EN, United Kingdom, +44 (0) 161 834 2454; fax +44 (0) 
161 834 2148; sales@salford-softzvare.com. 
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Crescent Updates VB4 Client/Server Tool 

EnQuiry v2.0 is the latest version of Crescent's tool that 
lets VB 4.0 programmers visually build database forms and 
queries without coding. The product integrates with VB 
and lets programmers point and click to build SQL queries 
and lay out data-bound controls. A wizard helps program¬ 
mers create queries that work the first time. 


DLL Offers Serious Encryption 

carrick vl .0 is a new DLL that provides encryption to 
Windows applications via the new Blowfish algorithm. The 
product is also available as a standalone application that 
users can use to encrypt files. The product cannot be sold 
outside the U.S. and it allows passwords of up to 448 bits. 

A working demo version of the product is available on the 
company's home page. 


EnQuiry 2.0 costs $299. For more information, contact 
Crescent, a division of Progress Software Corporation, 14 
Oak Park, Bedford, MA 01730, (800) 352-2742 or (617) 280- 
3000; fax (617) 280-4025; crescent@progress.com; 
http:!lwww.progress.com!crescent. 


carrick vl.O costs $159 for single users and $199 for a 
two-copv bundle. For more information, contact Azalea 
Software, PO Box 16745, Seattle, WA 98116, (800) 
ENCRYPT or (206) 932-0234; carrick@azalea.com; 
http://www.encryption.com. 


Data Widgets v2.0 Provides VB4 Data-Bound Controls 


Data Widgets v2.0 is a re-architected set of 16- and 32- 
bit OLE controls for developing database application front 
ends. The included DataGrid is a drop-in replacement for 
the grid in VB 4.0; it lets you edit an entire record set of any 
size on screen without writing code. It supports movable 
groups and columns, including dropdowns in headings 
that let users select from a list of available fields or groups 
at runtime. The DataGrid also features multiline rows, and 
can display with a variety of formatting options and data 
types in any column, row, or individual cell. 

The DataCombo is a bound combo box with a variable- 
height edit area. It includes a multiline edit area with a 


Bricklin Updates deino-it! 

demo-it! v2.0 is the latest version of Dan Bricklin's tool 
for creating Windows demo programs. This version can 
import RTF files, and features variables, a heartbeat clock, 
simulated typing, filmstrip animation, object sets, and scal¬ 
ing bitmaps. The package includes more transitions, finer 
time control on animation and transitions, and more con¬ 
trol for playing .wav files. 


dropdown display not limited to the width of the edit area. 
The Enhanced Data Control behaves as a front end to the 
VB data control, adding bookmark navigation and page 
movement. The Data Command Button lets developers cre¬ 
ate buttons that perform database functions. 

Data Widgets v2.0 costs $139; upgrades are $79. For 
more information, contact Sheridan Softxvare Systems, 

Inc., 35 Pinelawn Road, Suite 206E, Melville, NY 11747, 
(516) 753-0985; fax (516) 753- 3661; BBS (516) 753-5452; 
http://www.shersoft.com; CompuServe: GO SHERIDAN. 


demo-it! v2.0 costs $399; upgrades are $89, and compet¬ 
itive upgrades from demoSHIELD and DEMOquick cost 
$99. For more information, contact Lifeboat Publishing, 
1163 Shrewsbury Avenue, Shrewsbury, NJ 07702, (800) 447- 
1955 or (908) 933-1346. 


REQUISITE Ships Management Groupware 


Requisite vl.5 is the latest version of a requirements 
management tool for Windows developers. Requisite 
dynamically links a database to Microsoft Word to create a 
3-D document repository that holds a development team's 
project documents, requirements, requirement attributes, 
and traceability relationships. Individual requirements are 


itemized from within project documents and managed 
with the integrated database. 

Requisite vl.5 costs $795. For more information, contact 
REQUISITE, Inc., 4720 Table Mesa Drive, Suite F, Boulder, 
CO 80303, (800) 732-4047 or (303) 499-9177; fax (303) 499- 
9535; 71613.407@compuserve.com. 
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(text continued from page 40) 

PC programmer — I've seen firsthand that 
software design and documentation can he 
an order of magnitude better than what 
Microsoft produces for programmers. But 
there l go again. I do try to keep an eye out 
for the good things Microsoft does and point 
them out. For example, I was happy to note 
that they had indicated they would docu¬ 
ment the shell namespace interface. 
Unfortunately, they then failed to deliver. 
Help me out, readers — send me email and 
point out all the best things Microsoft does 
for programmers. Maybe we can create a 
special pro-Microsoft issue, like one of those 
newspapers that devote one page to nothing 
but good news! —rib 
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Readers' Forum 


Send letters to wdletter@rdpub.com. 


From: Etay Szekely 
<etay@emultek.co.il> 

To: wdletter@rdpub.com 
Subject: MFC everywhere 
Hi, 

I really like your magazine, mostly 
because of the thoroughness of the tech¬ 
nical articles. Recently, I noticed that 
there is less to read there for non-MFC 
programmers. For example, in the last 
issue (January 96), two of the four fea¬ 
ture articles were about MFC program¬ 
ming. These were probably very good 
articles as usual, but for me there is no 
reason to even take a first look inside. 

I don't say ban MFC, but please 
don't devote so much of your magazine 
to it. 

January was our MFC theme issue, so it 
was inevitably of less interest to non-MFC 
programmers (though there was plenty of 
other content besides the two MFC articles). 
In general, we agree with you — we don't 
plan to ban MFC, nor do we plan to let it 
dominate the magazine. —rib 


To: 70302.2566@compuserve.com 
From: "Reinhold J. Gerharz" 
<rgerharz@mail.erols.com> 

Subject: WinDev journal and iostreams... 

Ron, 

Your magazine gets better every 
year! I am almost at the point of reading 
it "cover-to-cover". (There's an article 
about Delphi in the February issue I'm 
not going to read.) 

When I read your "Call for Papers" 
suggested topic of a benchmark com¬ 
paring C++ stream I/O to normal C 
I/O, I thought, "He musta read my 
mind!" You see, I recently wrote a pro¬ 
gram that writes several hundred-thou¬ 
sand floating-point numbers to a text 
file. While looking for a way to speed 
things up, it occurred to me that using 
stream i/o instead of fprintf would 
remove from the runtime environment 
the burden of re-interpreting the type 
and precision of every single floating¬ 
point value as it was being output. 


Instead, C++ would call the stream i/o 
function that outputs floating-point 
numbers directly, using the binary val¬ 
ues for size and precision that are set by 
stream manipulators, I thought! 

Imagine my disappointment, while 
tracing through the program, to discov¬ 
er that the stream i/o function simply 
places "%<size>.<precision>g" in a 
char array and calls sprintf! So, the 
sequence of operations is to first convert 
the size and precision to ascii, call 
sprintf, which then converts the size 
and precision back to binary, interpret 
the "g", and call the appropriate con¬ 
version routine. Thus, the advantage of 
C++ compile-time type checking is 
replaced with the overhead of a wrap¬ 
per function for a run-time type inter¬ 
preting function. 

I haven't the resources to compare 
products from differing vendors, so I 
don't know if everybody does it this 
way. Hopefully, your benchmark article 
will materialize to answer this question. 
And maybe my vendor will feel com¬ 
pelled to find a better way. 

Regards, 

Reinhold Gerharz 

Very interesting! Alas, no one has 
stepped forward to provide the kind of 
benchmarks I'm looking for. Constructing 
even a simple benchmark that really mea¬ 
sures what you intend to measure can be a 
bit of a challenge. Plus, I really want the 
benchmark to produce a number that is a 
ratio that is fairly consistent across different 
machine environments. Anyone out there 
want to take up the challenge? —rib 


From: "AL Moayyed Int'l Group" 
<aigbah@batelco.com.bh> 

Subject: Capture text from an emulator 

running under Windows 

To: 70302.2566@compuserve.com 

I have a requirement wherein I need 
to capture text from an emulator win¬ 
dow running under Windows 3.1. I 
think the best way to do this would be 
to capture the emulator screen on the 
clipboard and have my program parse 
the clipboard data to get the neccessary 
information. This is simple if the emula¬ 
tor has a Select All command, because 
then I could use a SendMessage( ) to that 


window with the WM_COMMAND parameter 
with the appropriate value. But if there 
is no such command then I would have 
to mark the text on the emulator screen 
with the mouse and then use the copy 
command. But what messages will I 
have to send to the emulator window to 
simulate marking of the entire screen 
with the mouse? I have tried using 
SendMessageO with WM_LBUTTONDOWN, 
WM_M0USEMOVE and WM_LBUTTONUP. But this 
doesn't seem to work. How can I 
achieve what I want. 

Sudeep 

I can't answer your question in depth, 
but I can give you a couple of pointers. 
First, the correct way to simulate keyboard 
and mouse input is not the obvious way 
(SendMessageO). Instead, you have to take 
the less-than-obvious approach of using a 
journal playback hook. Start by reading 
about this hook in the SetWindowsHookEx() 
documentation. Second, if by “emulator" 
you mean a DOS box, then you have a dif¬ 
ferent can of worms to deal with, and a VxD 
is the only robust solution. If that's the case, 
you really might want to check out the prod¬ 
ucts from WINGate Technologies 
(wingate@wingate.com, 
http://www.wingate.com). They've done 
the hard part, which is providing a VxD 
(and an easy interface to it) that gives you a 
high degree of control over DOS boxes. — 
rib 


Subject: http://www.wdj.com 

When I set the address of your Web 
sight, I get a "connection refused" error 
with Netscape. Being fairly new to the 
web, is this my fault? 

Thanx in advance, 

Andy 

Definitely not. As many readers discov¬ 
ered, our Web site did not get up and run¬ 
ning quite as soon as we had predicted. It's 
up now, though, so drop by 
http://www.wdj.com and check it out! I 
apologize for the frustration of everyone 
who tried to get to it early on. —rib 


From: <GHollerich@aol.com> 

To: 70302.2566@compuserve.com 
Subject: Accessibility to Library 7 
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In your editorial for the February 
issue of Windows Developer's Journal, you 
mentioned a number of items available 
in Library 7 on SDFORUM on Com¬ 
puServe. Can these items be obtained via 
INTERNET and a local distributor? If so, 
how? 

Gil Hoellerich 

The table of contents of each issue of the 
magazine contains a box labeled "Online 
Source Code" that lists some of the many 
places you can obtain our source code. In 
particular, you can FTP our code from 
ftp.mfi .com (in pub/windev). For the Web- 
enabled, check out our site at 
http://www.wdj.com; Carl Bettis did a 
great job setting this site up. —rib 

From: Kent Stephenson 
<AKS@ldg.com> 

Subject: Win95 i/o 

WDJ staff, 

I am developing with Win95 and it 
seems that the inport and outport func¬ 
tions are gone in the Win32 API. I need to 
get to the hardware ports with Win95 
API. My product has many custom 1/O 
chips that I have to set up. Please advise. 

Port I/O has never been a part of the 
Windows API — it is the responsibility of 
the language, compiler, or development 
environment you use. Check with the vendor 
of whatever product you are using. In par¬ 
ticular, if you are using Visual C++ and just 
switched to version 4.x, you may need to call 
_i n p () rather than i n p (). Check your docu¬ 
mentation. —rib 


From: "Jordao, Felipe" 
<jordaof@moodys.com> 

To: wdletter@rdpub.com 
Subject: MFC or API? 

Hi, 

I have started programming for 
Windows and I feel that I've reached an 
intersection and don't know which way 
to go. I read Petzold's Programming Win 
3.1 and Inside Visual C++ 1.5, trying to 
decide if I should code using the API or 
with MFC. I like the 3.1 API because it 
gives me a feeling of being more in con¬ 
trol of the system. I like MFC because it 
gives the benefits of programming in 
C++ as opposed to plain C using the 
API. My question is: which should I 
learn? I see pros and cons for both, but I 
don't want to devote a lot of time to one 
field finding out later on that I should 
have gone the other way. MFC will let 
me use C++ and all the nice things that 
come with it. The API will give me good 
code that's small in size (kb) and allows 
more control as well as being able to 
program with any Windows compiler. 
MFC might keep me in a stranglehold 
for using only Microsoft compilers and 
it may not be widespread in the long run 
(being taken over by OWL or maybe 
something new).Any tips since you 
guys are more 'in-tune' with the indus¬ 
try? 

Thanks, 

Felipe 

There is no one answer to the question 
that is correct for everyone, as I'm sure you 
know, but I can give you some opinions. You 
can definitely make smaller programs by 
avoiding MFC. However, once the size of 
your program gets past a certain size 


(200Kb?) the cost of adding MFC is not nec¬ 
essarily significant. You can almost always 
bypass MFC and go directly to the API, 
though that may require you to sometimes be 
more intimate with the source to MFC than 
is pleasant. 

The problem that using MFC ties you to 
a specific compiler is almost not a problem. 
Every major PC C++ compiler except 
Borland's comes with MFC (though often a 
release older than the latest Visual C++ ver¬ 
sion). In fact, Borland would like to include 
MFC with their compiler, but Microsoft 
won't license it to them unless they take 
OWL out of the box. So, next best thing, 
Borland is making sure that with BC++ v5.0 
you can at least compile MFC (the MFC 
team stubbornly insist on using illegal lan¬ 
guage constructs that Visual C++ accepts 
but Borland C++ did not) and use it with 
their compiler if you want. 

I wouldn't worry about MFC disappear¬ 
ing. MFC is here to stay, at least as much as 
anything in our business is here to stay. If 
the main thing keeping you from using it is 
fear that Microsoft will abandon it, I would 
not worry about it. I do not use MFC 
because I have to write source code that will 
be used, read, and modified by people who 
either don't have MFC (Borland users) or 
who simply don't use MFC. Our surveys 
show that many people use MFC, but a 
much smaller percentage of people use it in 
much depth (e.g., beyond having wizards 
generate MFC code for them). 

In my opinion, the main roadblock to 
MFC becoming universal at this point is 
Microsoft. If Microsoft would sell Borland 
an MFC license with no anti-competitive 
strings attached, then there would really be 
little to keep everyone (even me!) from using 
MFC. I don't know what official reasons 
they give for refusing to do this, but it sure 
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looks like they're afraid to have MFC appear 
in the same box with Borland's OWL 
because they fear there will then be absolute¬ 
ly no reason for anyone to buy Visual C++ 
instead of Borland C++. Cmon Microsoft 
— show some confidence in your product 
and sell Borland the same license you sell all 
the other compiler vendors! —rib 


Fm: Sven B. Schreiber [100557,177] 

To: Ron Burk [70302,2566] 

Ron, 

Just wanted to tell you that I particu¬ 
larly liked the article of Paula Tomlinson 
on Windows NT services in WDJ 07.02. 
It's of great help for Windows NT sys¬ 
tem level programmers. I'd like to see 
more of this stuff in WDJ issues to come. 


Ciao... 

Sven 
100557,177 
Herzogenaurach, Germany 

I've been learning new NT stuff myself 
with every installment of that column. 
Writing NT services seems to be a somewhat 
popular topic, and Paula is going to return 
to that subject next month. She's been writ¬ 
ing a service as part of her day job and run¬ 
ning into the many gotcha's, including the 
security issues and problems of interacting 
with the user from a service. S tay tuned for 
tips on writing services! —rib 


To: wdletter@rdpub.com 
From: "petter.hesselberg" 
<petter.hesselberg@ac.com> 


Subject: SDK Annotations 

While I greatly appreciate your SDK 
annotations, and had no trouble using 
the supplied program to annotate my 
16-bit Win-API help file, I don't quite 
know what to do about the 32-bit anno¬ 
tations. I'm using Visual C++ 4.0, and 
I've copied the whole "books online" to 
my harddisk. None of the suggested 
help files exist in my installation. 
Comments? 

This is my fault. We never received a 
review copy of Visual C++ v4.0, so at the 
time I made the automatic annotation utili¬ 
ty I was just hoping everyone would contin¬ 
ue to use WinHelp. As you know, that 
turned out not to be true —• Visual C++ 
v4.0 is using some other software for its 
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the usual editor features, plus a 
massive, 447-function macro language 
for the ultimate in configurability. 


See for yourself. Download a free, 100% 
functional, evaluation copy, now. 


• for /our full, free, ei/al copy: 

Web: http://www.windowware.com 
FTP: ftp.windovware.com in /wwwftp/wilson 
CompuServe: WINAPA, Sec. 15 
BBS: 206-935-5198 

£ 


Orders: 1-800-938-4599 
or from our secure Web server 
Wilson WindowWare, Inc. 
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Windows NT Drivers 


Development 

Consulting 

Training 

by the best in the industry 

• File Systems • Kernel Mode Drivers 

• NDIS Drivers • Systems Internals 



Open Systems Resources, Inc. 
105 Route 101 A, Suite 19 
Amherst, NH 03031 
(603) 595-6500 — info@osr.com 


Call or email for a free no obligation quarterly subscription to 
The NT Insider , the world’s only newsletter dedicated entirely 
to Windows NT systems software development! 


CDROJVIs! 


Official Slackware™ Linux - Slackware 3.0 (ELF) Linux, by author of 
Slackware. Easy install: learn Unix. XFree86 3.1.2, Td/Tk, GCC 
(2.7.0) compiler, Doom™. Works on 98% of PC's. 2 discs. $39.95 
Slackware subscription - convenient 3 month updates. $24.95 
FreeBSD® 2.1 - Berkeley BSD for PC. Solid Unix«-like, src, XFree86 
3.1.1, dev. tools, etc. (Subscription every 6 mo. $24.95) $39.95 
CUG Library -10 years C/C++ Users'Journal src, listings. $49.95 
CICA® MS Windows - 5000 up-to-date shareware. 2 CDs. $29.95’ 
Hobbes OS/2 Archived - 1000MB OS/2 apps, drivers. $29.95’ 
Blackhawk 95 - 200 MB great Windows 95 applications. $29.95’ 
Newt for NT - Windows NT app's, src, utils, GNU, drivers. $39.95’ 
Simtel® MSDOS - Two disc set, classic MSDOS shareware. $29.95’ 
Science Library - Technical, engineering shareware + book. $39.95’ 
Perl - Source, binaries for many systems, documents. $39.95 
Math Solutions - Math programs, source code, docs. $39.95’ 
POV-Ray - 3-D Raytracing: 1000 wow! images, src/binaries. $39.95 

•Shareware programs require separate payment to authors if found useful 

— Authors wanted. Please email discdev@cdrom.com — 


ORDER NOW! 1-800-786-9907 


Shipping is $5 in USA/Canada/Mexico, $9 Overseas per order 

«* | 

j [ 


jsl & SSL I 



Walnut Creek CDROM 

‘ Suite D-693, 4041 Pike Lane, Concord CA 94520 
Phone: +1-510-674-0783 • FAX: +1-510-674-0821 • email:orders@cdrom.com 
All of our CDROMs are 100% unconditionally guaranteed! 

Call today for your free catalog of all our CDROM titles! i - i 

See these products free at http://www.cdrom.com/ Adcode: 693 
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H I P.XTCT IS T ONGH AND 

l> R () V 1-: S S I O N A 1- 

Handwriting Recognition Software 

Software Developer Kit (SDK) 

Use our new SDK for high user acceptance of 
your pen applications. Lexicus Longhand 
provides a fast and natural method of data 
input. With our SDK, the creation and 
prototyping of your pen-based applications has 
never been easier. The SDK includes: 

- Dictionary Building Tools 
- Custom VBX Controls 
- Documentation 
- Code Samples 

1-800-LEXICUS 

415-462-6800 

http://www.lexicus.mot.com 

(M) MOTOROLA 

Lexicus Division 
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Employment Service 


SALARIED SOFTWARE 
DEVELOPMENT AND 
SUPPORT ENGINEERS 


Clients and affiliates nationally... 
Clients pay our fees (always), and 
your interview and relocation 
expenses (usually). 

RSVP SERVICES 

trusted by computer professionals 
since 1966 


Ref: WDDJ 

PO Box 8369 Cherry Hill NJ 08002-0369 
Voice: 800/222-0153 
Fax: 609/667-2606 
Internet: npa1621@connectinc.com 


mall/fax/email resume J 
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NuGraf® Developer's 3D Toolkit 


NuGraf is a complete drop-in solution for de¬ 
velopers seeking to integrate advanced 3D ren¬ 
dering technology into a new or existing CAD, 
modeling or visualization application. 

Features a mature, robust 
and proven photo-realis¬ 
tic Tenderer of impeccable 
quality and speed, a hier¬ 
archical database man¬ 
ager, a wide selection of 
3D modeling primitives 
(mesh, patch, NURBs), a 
hierarchical picking 
mechanism and a programmable output driver 
subsystem. Multi-platform: PC (DOS, Windows 
3.1/95/NT, Watcom) & UNIX. See WEB site for 
information, online API, demos and image gal¬ 
lery. $995 and $3500. M/C, VISA. 


Okino 6271 Dorman Road, Unit#6 
Computer Mississauga, Ontario, L4V 1H1 

Graphics, Inc. T: < 905 ) 672-9328, f -. 672-2706 

Email: saies@okino.com, WEB: http://www.okino.com 

□ Request Reader Service #167 o 




Developer Jobs! ' 

Internet: ngi@scientiflc.com 

Commercial software developers should con¬ 
sider registering with Scientific Placement. 
R&D jobs for software engineers, SQA, prod¬ 
uct managers, etc. Nationwide contacts with 
both large and small companies including 
start-ups. Many clients develop commercial 
software products. Most develop for Win¬ 
dows, NT, Macintosh, OS/2, and Unix based 
platforms. We also recruit in other leading 
edge technology areas such as PDA, low level 
ana real-time, compilers, etc. Managed by 
graduate engineers. Send resume or call for a 
marketability assessment. Never a fee. 

Scientific Placement, Inc. 
800-231-5920 Fax 800-757-9003 
http://www.sdentific.com 

CompuServe:71250,3001 AOL:davesmall 
SP18, Box 19949, Houston, TX 77224 
713-496-6100 Fax:713496-0373 
SPI8, Box 71, San Ramon, CA 94583 
510-733-6168 Beth@spica.bdi.com 
SFI8, Kenmore Station, Box 15225 
Boston, MA 02215 617-424-8372 jen@spbos.pn.com 
SPI8, P. O. Box 202676. Austin, TX 78720-2676 
y 512-260-0123 lej@zilker.net _ J 
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Add ZIP (and UNZIP too!) to 
your Windows applications! 


.DynaZIP 30 

| Data Compression Toolkits 


The new ROYALTY-FREE DynaZIP family of 
developer's tools let you add ZIP and 
UNZIP capabilities to your Windows 
applications. No more "shelling 1 ’ to 
DOS, no more fussing with proprietary 
compression formats. DLLs, VBXs, OCXs 
and a new database interface provide 
full access from many languages. Fast, 
reliable, and easy to use! 16 and 32 
bit versions, supports long filenames. 


Fully Supported, 
w/30-day no-risk guarantee! 
Call today, toll free: (800) 962-2949 


Inner Media, Inc., Hollis NH USA (603) 465-3216, fax (603) 465-7195 
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Demo / Tutorial / CBT / Presentation 
Visual Windows Automation 
Multimedia Authoring Development Kit 

G Use ShowBasic Recorder to generate the editable, 
mouse/keyboard simulation code invariant to window's 
size and position, screen resolution and video driver. 

G Achieve visual control over external applications 
and unlimited flexibility by programming in full 
featured Basic extended with the unique presentation 
and CBT related functionality, use even access to 
external DLLs and Windows™ 16-bit or 32-bit API. 

Q Pack your application in a compressed executable 
with the small self-installed run-time and all supporting 
files (BMP. WMF. WAV, MIDI. AVI), compatible with 
Windows 3.1, Windows 95 and Windows NT . 

□ Deliver your titles transparently via WWW - 
ShowBasic can be integrated with any WEB browser. 

Development license $299 with 30 day money back guarantee. Royally free license $X95 

If you don't need all the power of ShowBasic - use our simple, 
vet flexible scripting language for live demos and automation: 

STIDXEMO 

Single-user license $30 ($60 Pro). Royally free license $300 ($500 Pro). Visa/MC accepted. 

Find more information, demos, samples and evaluation copy: 

http://www.cnj.digex.net/~mik 
MIKSoft, Inc. tel/fax: 908-390-8986 

37 Landsdowne Road. East Brunswick NJ, 08816 
Internet: mik@cnj.digex.net CompuServe: 74127.3671 
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C and C++ DOCUMENTATION 


!! VERSION 6.01! 

• C-CALL ($69) Graphic-tree of caller/called 
functions, cross-ref, file/function index. 

• C-CMT ($69) Creates/inserts/updates comment- 
blocks for each function, listing the functions 
and identifiers used by it. 

• C-METRIC ($59) Counts path complexity, counts 
comments, code, 'C 1 statements. 

• C-LIST ($69) Lists and action-diagrams, or 
reformats into standard formats. 

• C-REF ($69) Creates cross-reference of local/ 
global/define/parameter identifiers. 

• C-DOC ($199) Package All 5 programs integrated 
as DOS program. <10,000 lines. 

V6.0 C-BR0WSE Windows graphic-tree viewer. 

• C-DOC Professional ($299) DOS, Windows, OS/2. 
3-ring binder/case. <1,000,000 lines. 

30-DAY Money-back guarantee. CALL NOW! 

SOFTWARE BLACKSMITHS INC. 

6064 St Ives Way, Mississauga Voice/Fax (905) 858-4466 
ONT Canada L5N-4M1 http://swbs.idirect.com 


Please see Ad Index for our larger ad. 
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-0 Design Tool 



WITH CLASS 3.0 Available: 


• Reverse header files with EASE! 

• Import/Export C++ Source Code 

• Generate C++, Java, Delphi Code 

• Template driven Code and Report 
generation - State,Class & Obj. Int. Diagrams 

• Scripting interface to generate Custom 
Reports and Custom Code 

• NEW - Supports Unified Method 
WITH CLASS $195/Enterprise $395 


Download Demo: WWW.miCrogOld.com 

v. 908.668.4779 f.908.668.4386 

email:71 543.11 72®com puserve.com 
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* Dazzle/VB - image manipulation. $199 

* VBIite - print/comm/array/B-Tree index.. $149 

* ProMatn/VB - numerics/statistics. $149 

* FinLib/VB - financial calculations. $149 

* QuickLine/VB - telephony (multi-line) ...$495 

* SpellCheck/VB - spelling & lookup. $49 

* QB/C/dBase - 15 more DOS libraries ...$call 

* Custom - C, VB, ASM programming. 


Develop your VB app faster: Get TeraTech 
tools! Call, E-mail or fax us and well mail you a 
free demo disk ASAP. Or for faster service 
d ownload by FTP or from our BBS. Call now! 

800-447-9120 ext. 1223 

Dept. 1223,100 Park Avenue, Suite 360, Rockville, MD 20850 USA 
Int’l:+1-301-424-3903 Fax:(301)762-8185 BBS: (301) 762-8184 

Copyright TeraTech 1995. Al rights reserved. Trademarks are the property of their holders. 
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online help. I don't know if I can make 
AnnTater work the same magic on that tool 
that it does on standard WinHelp files, but 
if I get some spare time I will try to figure it 
out. I apologize for the inconvenience. —rib 


From: Neil Sandlin 
<neilsa@microsoft.com> 

To:'"70302.2566@compuserve.com'" 
Subject: Direction flag 

Regarding the article on the direction 
flag (Windows Bug of the Month, March 
96 WDJ): While this subject is well 
worth discussing (I have personally 
debugged several nasty crashes involv¬ 
ing this flag), there are conclusions 
drawn in the article that are fundamen¬ 
tally incorrect. In the article, Roger 
asserts that in Windows programming. 


"the convention has always been that 
you are responsible for clearing or set¬ 
ting the direction flag before you exe¬ 
cute any repeated string instruction." In 
fact, the convention for most compilers 
that I have direct experience with is that 
on entry to or exit from a function, the 
flag must be clear, period. Code that fol¬ 
lows a function prolog, for example, 
may safely assume that DF is zero 
(excepting interrupt handlers, of 
course).The reasoning behind this con¬ 
vention is simple: Because, as you point 
out in your article, the majority of string 
operations is performed with DF clear, if 
all code assumes it is clear, you save one 
byte of code for each typical string oper¬ 
ation. This is such a cheap optimization 
that it really doesn't make sense to do 
otherwise. 


There are a number of articles on 
MSDN that describe the correct usage of 
the direction flag with MS compilers. 
Searching on the string "direction flag" 
gives a number of useful hits. There is 
enough there to clearly identify your 
usage of the DF in your sample program 
as incorrect. For example, I refer you to 
the VC++ documentation "Programming 
Techniques, 4.5 Using and Preserving 
Registers": 

Note: If your inline assembly code 
changes the direction flag using the 
STD or CLD instructions, you must 
restore the flag to its original value. 

In addition, having DF clear on entry to 
a function is documented as being a 
basic property of the PASCAL calling 
convention. Contrary to the premise of 



Developer's 

Marketplace™ 


S/W ENGINEERING POSITIONS NATIONWIDE 



We Understand 
Programmer's 
Mind* 


When the country's 
top firms look for 
the best develop¬ 
ers available, they 
turn to Bateman. 
Why? Because we 
specialize in MS 
Windows, NT, OS/ 
2 and Macintosh re¬ 
cruiting nationwide. 
So if it's time for a 
career move, give 
us a call. We un¬ 
derstand your 
skills, and the mar¬ 
ketplace for them... 
we understand you. 


K Bateman Inc. 


5847A Uplander Way 
Culver City, CA 90230 
Tel: 310-641-4100 Fax:310-641-2900 
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PROGRAMMERS... 

$100k/yr at HOME! 


My new book, "How To Make $100,000 A 
Year And More Developing Low Budget 
Software Products", will reveal all the 
marketing tricks, strategies, and systems that 
have my business exploding with PROFITS! 

Add your skills to my proven strategies and 
you have the PERFECT BUSINESS — Low 
overhead, part-time, home-based, huge 
margins, and UNLIMITED POTENTIAL . 


CALL 800-364-4883 


Call TODAY for a FREE special report! 
ULTRA Fax: 214-724-0375 

Financial Systems CompuServe: 71223,634 

1633 Arrowhead Dr, Rower Mound, TX 75028 
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www.dice.com 


DICE is looking for Data Processing, Engineering and 
Technical Writing professionals to fill open positions 
for companies nationwide. 

DICE is a FREE online job search service, providing 
detailed information about current contract and fulltime 
positions across the USA. Please contact by calling ANY of 
these access numbers, using your computer & 1200-9600 
baud Modem, 8-N-l. 


California. 

Georgia 

Illinois 

Iowa 

Massachusetts 
New Jersey 
Texas 
Internet 
Web 


408-737-9339 
404-523-1341 
708-782-0960 
515-280-3423 
617-266-1080 
201-242-4166 
214-691-3420 
telnet dice.com 
www.dice.com 


DATA PROCESSING 
I NDEPENDENT 

Consultant's i 
E XCHANGE . 


A Service of D&L Online, Inc:. (515) 280-1144 


□ Request Reader Service #176 ci 


C++ Windows Developers 


Compuware Corporation 

has immediate, challenging positions for 
people who have experience with C++/OOD 
Windows Development. We are looking 
for people who are willing to travel, and 
capable of managing projects. 

We offer a pleasant working environment 
that dynamic team players find especially 
attractive and rewarding. 

Contact Lisa Hansen, by phone at 
1-800-527-8462 or 414-225-4000. 

You may also fax your resume to 
414-225-4011. Refer to Dept. CUJ0204. 

For more information, see our home page 
http: / / www.compuware.com 

COMPUWARE 

BU iw Opportunity Employer 

732 N. Jackson Street 
Milwaukee, W1 53202 


Dr. DeeBee® 
ODBC Tools 


Tools for ODBC^development 

Ever wonder why 
your ODBC app is not 
working? Why it’s just 
too slow? If the ODBC 
driver is OK? 

Dr. DeeBee utilities reveal the inner workings of ODBC. 



□r. DeeBee ODBC Driver Kit 



Connect proprietary databases to 
Access, Visual Basic, and PowerBuilder 
with our Dr. DeeBee ODBC Driver Kit 


-SYVWBEZ - 

RO, Box 91 Kendall, Cambridge, MA 02142 

617-497-1376 Fax 617-497-8729 
http: //www. syware .com 


-i Request Reader Service #178 i 


Page 78 — Windows Developer's Journal 


May 1996 















































Spy on any Windows Program! 


API Vision 



Total detail display for 2000+ APIs in 36 
categories, including base APIs, drivers, 
multimedia, networking, OLE, winsock, 
undoes and more. - 

“Insanely Great” $199+ w ship. 

c u i .»« MasterCard, Visa 

Software Development Magazine 30 day money . bad . guarantee 


2600 Tenth Street, Suite 415 

Berkeley Toolworks Berkeley ,ca 94710 

800-593-5103 510-649-9891 apivis@berktool.com 
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Application 

Development 

Tools? 

We are a well-established German distributor for 
application development tools with branches in Austria 
and Switzerland. 

We are highly interested in enlarging our product range 
with new tools and utilities. 

We have a well maintained list of customers, are 
experienced in launching new products into the market are 
able to offer high level technical support and are 
experienced in translating software. 

Please contact us if you are interested in a long term 
partnership: 

O.K. Marketing Group 
Mrs. Brigitte Globig 
Fax +49/6172-74297 
CompuServe 100015,2451 



The best high 
performance, 
portable 
compression 
libraries for 


DOS, Windows, 
OS/2, Unix, 
Macintosh, 
embedded systems, 
and practically anything 
else, period. 


FREE DEMO 

DOS $249 

Winl 6 $299 

Win32 $299 

OS/2 $349 

Unix $349 

Macintosh $299 


45-function API 
Buffer compression 
File compression 
Disk spanning 
Encryption 
Self-extracting EXE's 
VBX/OCX controls 
On-line help 
Full source code 


DC Micro Tel 606-268-1559 

Development Fax 606-266-0726 

Call 1-800-775-1073 

info@dcmicro.com http://www.dcmicro.com 
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Web Page: http://www.bluewatersystems.com 
HASSLE FREE HARDWARE CONTROL 

©WInRT 



■Avg.15% 

speed 


Windows95’"-* 


Win32 1 

Binary Compatible 


'►NT” 


Spend your time writing your App...not 
wading through DM documentation! 
Fast hardware control under Win32® 
without the device driver kit! 

VPort I/O /Memory I/O VInterupts 
OCX version also available 


Ask us about Alpha™, PowerPC™ S MIPS versions 

NO RUNTIME ROYALTIES 

VISA, MC, AMEX A Approved P.O. accepted 
Tel (206)771-3610 • Fax (206)771-2742 
E-Mail: lnfo@bluewatersystems.com 


( 800 ) 962-2114 




Micbosoft, 

Compatible 
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NT Driver Debugger 


Device Talk iu 

Single machine GUI debugger and 
debug library for NT DDK developers. 

♦ Trace statements 

♦ Breakpoints 

♦ Symbolic device extension viewing 

♦ Very simple to set up and use 


Other WinStar products... 


♦WinStar Hardware Classes hardware 
control library for Win32/VB4 apps. 

♦ Kernel BASIC cross-platform driver 
development environment 



WinStar Technologies^ 

(415) 647-2815 

74367.1773@compuserve.com 


visit us at http //www wintech com 
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Phone Sound: Simple! 

For Windows/DOS Voice Mail & Fax Developers 



1. Create fantastic prompts 
and save time with VFEdit®\ 
Record, crop, cut, copy, paste, 
mix, fade, echo, volume & 
more with your Dialogic™ 
D4x/12x boards. 

2. Add Voice Mail power to 
your MS Windows apps with 
TI/FDLL™, our Tel I/F 
Dynamic Link Library. 

3. Scribe plays digital audio 

files without voice hardware! 


Professional 
Tools for 
your Voice 
Mail, Fax & 
Audiotex 
Applications 


4. Add Text-to-Speech 
capability with VoxFonts ™, 
our text-to-speech library! 

5. Audio ToolBox™ 
converts between Multimedia 
Wave (16. 8 & MS ADPCM), 
unsigned 8, linear 16, CC1TT 
G.711/G.722, Dialogic 4/8 & 
more! Batch convert, crop, 
chop, normalize & filter. Add 
conversion to your apps with 
our ToolBox SDK\ 


VS/ Order Now! 800-234-VISI 


V1SI, 2118 Wilshire Bh/d, #973, Santa Monica, Ca 90403; 310-392-8780 
Fax 800-234-FXIT / BBS: 310-392-6610 (Download our Working Demos) 
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1 


The Fastest xBASE Engine... 

for C, C++, Visual Basic and Delphi 
database application programmers! 

With CodeBase 6.0, you get: 

• Multi-user compatibility with 
FoxPro, Clipper and dBASE files. 

• Portability between Windows, 

Win95, NT, DOS and UNIX. 

• Support for the popular C/C++ 
compilers, Visual Basic and Delphi. 

• Data aware controls for Windows. 

• Powerful visual report writer. 

• Client/Server option. 

• Royalty Free distribution. 

FREE 30 day trial 

Call Sequiter Software Inc. for details! 
Phone: 403 437 2410 FAX: 403 436 2999 
Internet: sequiter@supernet.ab.ca 
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Basic Scripting 


Cypress Enable 2.5 

Basic Scripting for Applications 

A powerful, complete, royalty free, VBA 
compatible, embeddable Basic Scripting 
Language. Cypress Enable Features: Royalty - 
free licensing, 30 day money back guarantee, 
OLE 2.0 Automation, Direct access to C++ 
objects, Dynamic Dialogs, Dialog Editor, 
Debugger (w/source), Named parameters, 
Easily extended, Printed & on-line 
Redistributable end-user documentation, Small 
footprint engine < 200K, Free tech support. 16 
bit $495, 16 & 32 bit in one box $995. For free 
whitepaper call: 1-800-790-4050 or visit our 



email cypress@cypressinc.com 
Fax:(602) 951-8047 www.cypressinc.com 
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The Weekly MFC Extension 

0 The only MFC extension class library that 
delivers new class(es) every week 
0 Updated through eMail 
0 Includes all classes available upon subscription 
0 Free sample classes available as demo 
0 Only $150 annual subscription 

Octo+ Dataview 


The Dataview client OCX and OLE server turn 
any ODBC compliant database into an advanced 
Client/Server environment. The OCX displays 
data through a user friendly grid. The 32bit 
multithreaded OLE automation server services 
remote OLE requests through high level objects. 
Includes SQL wizard that generates advanced 
dataviews (for local and remote databases) in 
minutes without requiring SQL knowledge. 


Only $299 


Contact 

eMail: info@periphere.com 1 


http://www.periphere.com | 
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the article, this is not a bug, and was not 
introduced with the release of Windows 
95. I'm pretty certain if you look hard 
enough, you will find some Win31 func¬ 
tions that fail for the same reason. 
Windows NT also uses this optimiza¬ 
tion, so I wouldn't be surprised to see 
similar results for a Win32 app that mis¬ 
uses this flag on an x86 NT system. 
Functions that succeed under these con¬ 
ditions do so by luck and not by design. 
In any case, the most important point 
for application writers is summarized at 
the end of your article, namely that you 
must not set the direction flag and leave 
it in that state. 

Regards, 

Neil Sandlin 


I agree with you that we were incorrect 
in saying that there was basically one con¬ 
vention for the direction flag. Clearly , there 
were other conventions on the scene for a 
long time, including the PASCAL calling 
sequence. I'm still not uncomfortable label¬ 
ing this as a bug for a couple of reasons. 
First, Microsoft made much ado about how 
much more robust Windows 95 would be 
than Windows 3.1, yet they made changes 
(admittedly saving a whole byte each time) 
that would cause a program that worked 
correctly under Windows 3.1 to crash 
Win95 hard — that's a bug in my mind. 
Second, Microsoft's incorrect and incom¬ 
plete API documentation never actually 
specifies in any detail what the PASCAL 
calling sequence is (note that compiler ven¬ 


dors cannot even agree on how to return a 
structure with this calling sequence), or 
even which functions use it. 

You can certainly piece together lots of 
information from header files, etc., but what 
is the official, documented word? Should we 
look to Microsoft compiler documentation 
to define the operating system? Do MSDN 
articles represent an official statement from 
Microsoft? Even when the author is 
"Herman Rodent"? Better operating sys¬ 
tem documentation from Microsoft would 
both reduce the need to debate what is and 
isn't a bug, and help programmers write 
programs less likely to crash the system. 
Thanks for writing — your email was the 
most well-reasoned that we received on this 
topic. —rib □ 
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SLSCOPE is a comprehensive serial 
analyzer that enables you to examine, 
and interact with the data on any 
serial line in real time from your PC! 


1 Capture and Analyze at Baud Rates 
up to 115K. 

i Selectable Formats Including 
ASCII and EBCDIC 

■ Pattern and Signal Searching 

■ Microsecond Timestamp Accuracy 

■ Manual and Cable Included 

■ 3 0 Day Money Back Guarantee 


"Easy to use and a great tool!" 

- M. Hicks, Clement Industries. 

"Much easier to use than my old Analyzer!" 

- J. Rhoads. Rhoads Systems Inc. 

Software Innovations Inc. -J4 

(914) 567-0805 s' \ 


63 Rock Cut Rd. Newburgh, NY CompuServe: 75013,3310 




Bar Codes Can Be Fun. 
Honest! 

If you can change fonts, you can 
create bar codes. Code 128, Code 
39, UPC, and other symbologies. 


800 48-ASOFT 
20 6 932.6028 
info@azalea.com 
www.azalea.com 



azalea 

softwares inc. 
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Call 800 - 645-3729 now for your 
free catalog about Sax Comm 
Objects, Sax Setup Wizard, Sax 
Webster Control, and Sax Basic 
Engine. 

http://www.saxsoft.com 


Phone: (541) 344-2235 
Fax: (541) 344-2459 
email: info@saxsoft.com i 
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Win-Emacs 

The Complete Emacs Text Editor 
for Microsoft Windows® 


NEW! 32-bit version 
for NT/Win95/Win 3.1 


Win-Emacs™ is a full implementation 
of XEmacs 19.6—including e-lisp 
interpreter—for just $199 

To Order Call 1 -800-WIN-EMACS 


Pearl Software Corporation 

Tel: 510-652-4361 • Fax: 510-652-4362 
http://www.pearlsoft.com/ 
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| Does your company 
provide tools, products, 
or services for advanced 
Windows programmers? 
Then reach over 22,000 
serious programmers in: 

Windows 

□ DEVELOPER'S JOURNAL 

The Magazine for Windows Programmers 


Call 913 - 841-1631 today for 

information about 
advertising opportunities in 
Windows Developer’s Journal. 


I breakout! marketing - Continental Europe. 

+49 431-801740 

I Ed - East I Christine - Midwest I Julie - West 
913-838-7547 1913-838-7546 1913-838-7541 
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Visit our Internet site at http://www.accusoft.com 


Platforms 

Supported 


The Ultimate High Performance Imaging Toolkit! 

Add Support for Over 36 File Formats Instantly ! 


Now with PNG!* 




PERFORMANCE 
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AccuSoft Image Format Library 5.0 


Ultimate Imaging Toolkit 

AccuSoft provides the ultimate imaging 
toolkit solution with the highest 
performance, most formats & platforms, 
most complete API and the best pricing. 
That is why we are the industry leader 
and why over 5000 companies have 
chosen AccuSoft for their imaging 
needs! 

Performance 

AccuSoft has always been known as the 
performance leader. We know that you 
want the fastest imaging possible and 
that fast is never fast enough. 

Therefore, we constantly work on 
improving performance to keep us 
(and you) ahead of the competition. 

Quality 

AccuSoft has become the leader in 
imaging toolkits due to our untiring 
commitment to quality. Not just 


Toll Free: (800) 525-3577 

Internet: http://www.accusoft.com 
CompuServe: Go AccuSoft 


product quality, which can be seen in 
our unique guarantees, but also service 
quality from our special fast delivery 
program, top rated technical support and 
rock-solid technology. 

Pro Gold 

The Pro Gold versions of our imaging 
toolkits are unbeatable for performance 
and special features like scale to gray, 
sub-degree rotation, sub-second 
decompress & display, sub-second 
screen rotation, huge image handling 
and more. 

If you want the best performance 
available anywhere at any price, this is 
it. 

Cross Platform 

With this toolkit, you can sell your 
applications on many different platforms 
without having to recode the imaging 
portion. AccuSoft's cross platform 


design is tailored for easy 
porting, and since we 
support ALL platforms, 
your products can be sold to 
every market. 

Order Today 

Call now and you can start 
writing high performance 
imaging applications in less 
than an hour. Our unique 30 
minute delivery program is 
also the fastest in the 
business! 



AccuSoft 

High Performance Imaging" 


Two Westborough Business Park Westborough, MA 01581 Tel (508) 898-2770 FAX (508) 898-9662 

All company and brand names are trademarks or registered trademarks of their respective owners. 

*Free Upgrade for 5.0 users. PNG is the replacement format for GIF. 1. Raster only 2. Read only (Does NOT require separate DLL from Kodak.) 

©1995 AccuSoft Corporation. All Rights Reserved. 


Windows 
Win 95\NT 
DOS 
DOS32 
VBX 
OCX 
OS/2 
FoxPro 
SUN OS 
Solaris 
HP-UX 
AIX 
SGI 
SCO 
MAC 

PowerMac 

Over 36 
File Formats 
Supported 

TIFF 
JPEG 
Group III 
Group IV 
PCX 
TGA 
DIB 
DCX 
GIF 
BMP 
WMF' 
PICT' 
WPG’ 
EPS' 

KFX 

RLE 

LV 

CALS 

ATT 

CLP 

XWD 

IMG 

IFF 

SUN 

XBM 

ICO 

IOCA 

GX2 

XPM 

ASCII 

CUT 

BRK 

MAC 

PSD 

MSP 

PNG 

Photo CD 2 



ACCUSOFT 


IMAGE .. 

GUARANTEE 

Look for the 
AccuSoft Image 
Guarantee™ 
or the AccuSoft 
trademark on 
your favorite 
software products 
as a statement of 
superior quality. 
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Announcing BoundsChecker 4.0 

Because There's More To Windows Error Detection 
Than Finding Memory Errors 



Time For A Change ... Use BoundsChecker 4.0 

Today's error detection challenges go far beyond C/C++ 
memory corruption and leaks to include much larger prob¬ 
lems. Interfaces and software layers are growing at a 
faster pace than most developers can keep up with. Tools, 
libraries, and components are isolating the developer from 
the actual interface with wrappers. And, many of the most 
costly bugs are interface-related and often several layers 
away from the source code. You need one tool that does 
the whole job. You need BoundsChecker! 


"Smart Debugging"™ For Visual C++ Users 

'Along with power and visibility, BoundsChecker 4.0 
achieves new levels of ease of use. BoundsChecker is now 
seamlessly integrated into the Microsoft Visual C++™ debug¬ 
ger. Because it is fully hosted by the IDE you can view your 
errors and immediately go to the offending source code. 
Every time you debug, BoundsChecker is transparently 
working to find additional hidden, costly bugs. By finding 
these bugs earlier in the process you will release higher 
quality software sooner. 


Here's Why: 

NuMega's BoundsChecker solves many of the complex 
interface-related problems that Windows developers are 
likely to encounter. If you are building COM-based 
software or using the Microsoft® Internet interfaces and 
APIs, BoundsChecker 4.0 is invaluable. It intercepts control 
and validates interfaces in thousands of strategic places, 
automatically pin-pointing errors. The event window then 
shows a step-by-step, layer-by-layer history of events that 
gjyes c clear picture of what software components were 
responsible. Because C/C++ memory bugs and leaks can 
still appear, BoundsChecker Professional Edition includes 
CTl v , the most advanced memory and leak detection 
technology available. No other debugging tool offers so 
much pov/er and visibility. 


New In BoundsChecker 4.0 
Parameter validation and logging of OLE interfaces 
Parameter validation and logging of Microsoft Internet 
interfaces and APIs 

User-extensible API validation (Validate your own APIs) 
"Smart Debugging" with the Visual C++ debugger 
(Evaluates each line of code for errors as you debug) 
Supports Borland Delphi® applications 

Call 1 -800-4-NUMEGA to order! 
Contact our web site to learn more about the 
exciting new features of BoundsChecker 4.0 

http://www.numega.com/bc4.html 


9 Townsend West • Nashua, NH 03063 • 603.889.2386 • Fax 603.889.1 135 

info@numega.com • http://www.numega.com/ 

NuMega Technologies, the NuMega logo, SoftICE, and the SoftlCE logo are trademarks of NuMega Technologies. 
All other trademarks are the property of their respective manufacturers. Copyright ©1996. All rights reserved. 
Compile Time Instrumentation (SCI) and Runtime-Pointer Tracking (RPT) technology provided by@ ParaSoft™ Corporation. 


NuMega 
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